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1.0 EXECUTIVE SUMMARY 


1.1 THE PROBLEM 


Photovoltaic systems need controls of varying scope depending on the 
system size and application. While low cost voltage regulators are 
adequate and available for small battery chargers, many larger or 
more complex systems require control algorithms which until now could 
only be achieved by costly custom engineered products. The problem 
is made more difficult because the modular nature of photovoltaic 
systems results in a great variety of controller requirements. 

As the cost of photovoltaic modules decreases, system control and 
related engineering costs become very important. To meet this need 
for flexibility with a minimum of customizing cost, and yet consume 
only a few watts of power is within the capabilities of today's 
microprocessor. 

The first unit was produced under D.O.E. contract DEN3-310 and tested 
for NASA at TriSolarCorp. This unit is photographed in Figure 1.1-1. 
It is a 5kW maximum power controlling battery charger which can also 
be configured as a 5kW batteryless motor drive. 

The entire controller interfaces with existing 500 watt MPC power 
modules, operates in a NEMA-U enclosure over an ambient temperature 
range of -25 degree C to +45 degrees C, operates from either a 12V 
battery or a 40V to 300V DC unregulated solar array or battery bus. 

1.2 HARDWARE DESCRIPTION 

The prototype microprocessor PV system controller consists of a NEMA- 
4 enclosure containing the following major electronic assemblies: 

A. Power Supply 

B. Display and Control Interface 

C. Resistor Divider Board 

D. Power Modules (10) 

E. Processor 

The power supply consists of a wide input range DC to DC down 
converter and a multi-output flyback DC to DC converter. The 
downconverter accepts 40V to 300V DC. 

The display board consists of a 4 1/2 digit LCD display, a 16 key 
membrane switch pad (calculator style), an audible alarm, and three 
LED's: RED, YELLOW, and GREEN. The keypad allows manual control 
(under password security) of the system and calls up any one of over 
50 different quantities to be displayed. The display normally shows 
battery state of charge but can display the voltage, current, or 
power of any array string, load bus, battery, motor, or other 
monitored point, monitored temperatures, or time of day. The LED's 
summarize system status: The GREEN LED shows that the processor is 

running and servicing timer interrupts. The RED LED indicates that 
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the battery is dangerously low' and loads have been shed, and the 
YELLOW LED indicates that stored energy is in short supply and should 
be conserved. 

The resistor divider board serves as an interface between the high 
voltages in the power system and the low voltage signals measured by 
the processor. 

The power modules are 500 watt DC to DC converters used, for the 
prototype, to couple the 180 volt nominal solar array inputs to the 
120 volt nominal battery and load bus. These are 20kHz switching 
type bucking converters, with typical efficiency of 98%. They 
include internal fast current limiting. Ten power modules are 
provided in the prototype. 

The processor is a large board containing the following parts: 

1. Central Processor: CPU, timer, ROM, RAM 

2. Analog input section: differential current, 
multiplexer, single-ended voltage multiplexer, 
and 10 bit plus sign A/D converter 

3. Display and control interface: UART for RS232 
interface support; PIA for keypad, LED, LCD, 
and interrupt support; 6 optoisolators for 
load control 

4. Array control buffers: 10 digital outputs 
which can be used as pulse width modulated 
20kHz signals for the power modules for 

maximum power point tracking, or can be used as DC level 
digital switch drive signals for discrete array control. 

The central processor is built around a 65C02 CPU, which operates at 
1MHz with an 8 bit data bus and a 16 bit address bus. This addresses 
, 16k bytes of CMOS EPROM and up to 6k bytes of CMOS RAM. (This 
program requires only 2k of RAM.) The heart of the analog input 
section is the AD7571 analog to digital converter. This new device 
is a CMOS low cost unit, with 10 bits plus sign accuracy, and 
internal interface to an 8 bit microprocessor bus. 

The RS232 port is provided by an IM6402 CMOS UART, which with a few 
discrete driver elements, makes a complete bi-directional 
asynchronoeus communications interface. This port allows data 
logging to an external printer, automated testing during manufacture, 
or computer interfacing in special applications. 

The array control functions consist of a set of latches, gates, and 
buffers allowing 12 digital outputs to be driven as independent relay 
drive signals for discrete array control, or as separately buffered 
pulse width modulated 20kHz signals for maximum power point tracking. 
A watchdog timer turns off the array control and load outputs if the 
processor fails to reset it within 240msec. An additional analog 
output, 0 to 10V, is available for continuous analog control of 
variable loads such as variable speed motor drives. This is realized 
by low pass filtering of a second PWM signal. 


2 
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1.3 SOFTWARE DESCRIPTION 


The software design was based on two decisions. First, the software 
is modular. This allows an orderly linking of software modules using 
the principles of structured programming and allows modules to be 
modified without interfering with the rest of the program. Second, 
the modules were defined using "pseudocode”, an explicit definition 
of each algorithm in plain English with a program format. This 
allowed clear communication between system designer, hardware 
designer, and software designer in advance of actual programming and 
eased the task of writing assembly language code. 


The MAC unit is designed to operate without needing any human 
intervention. It performs the following functions automatically: 


1 . Battery Control 

2. Array Control 

3. Load or auxiliary display on the 
control panel 

4. Status display on the control panel 

5. Self-test 

6. Data logging via RS232C port 


In addition, the MAC unit provides the following facilities for 
manual control: 


1. Manual battery charge initialization 

2. Manual array control 

3. Manual load or auxiliary charger control 

4. Control panel display of system 
operating parameters 

5. Manual test calibration mode and time of 
day 

6. Remote control and parameter measurement 
or automated testing via the RS232C port 

Each function is described below, with the automatic and manual 
functions described together for ease of understanding. 


1.3.1 Battery Control 

The state of charge describes the battery's condition at an instant 
in time. The initial battery state of charge can be entered manually 
from either the keyboard or the RS232C terminal. This can be based 
on a hydrometer reading of battery acid density, or simply an 
estimate. If it is wrong, the system will eventually correct it 
without damage to the battery. Default value at power-up is 50%. 

The state of charge is increased by the number of ampere-hours 
flowing into the battery, and decreased by the number of ampere-hours 
flowing out of the battery. Rate of increase is modified by a 
tabulated coulombic charging efficiency which depends on state of 
charge. If the battery voltage exceeds expected limits, the state of 
charge is automatically adjusted to account for the variation. 
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For every ampere-hour of discharge by the battery, one equalization 
fraction ampere-hour of extra or equalization charging is 
automatically programmed when energy becomes available and 100% state 
of charge has been reached. This is needed to bring all cells up to 
full charge and to stir the acid by generating small amounts of gas. 
This prolongs battery life. 

If the battery goes through many partial charge and discharge cycles 
before equalizing, the total equalization charge is limited to the 
equalization total percentage to avoid excessive water useage. 

During charging and equalization, the battery is allowed to rise to 
the equalization voltage. After equalization is completed, the 
battery voltage is limited to the float voltage, which is below the 
point of significant gassing and so uses up less water. This float 
level charge makes up for internal battery self-discharging. 

1.3.2 Array Control 

If the battery is not fully charged and equalized, the voltage limit 
is the equalization voltage. If fully equalized, the voltage limit 
is the float voltage. Until reaching voltage limit, the solar array 
charges the battery as much as the available energy allows. 

There are two automatic modes of array control resident in the 
program. The first is discrete array control. This turns' strings 
on, one per second as long as the battery voltage is less the 9^% of 
its maximum limit. It makes no change until the battery voltage 
reaches 97% of its maximum limit. Between 97% and 100% of its 
maximum limit, strings are turned off one per second. Above 100% of 
maximum limit, all strings are turned off. The battery voltage used 
for this algorithm is averaged over 4 samples to minimize noise 
problems. 

The second mode is maximum power tracking. The controller drives up 
to 10 power modules with a 20kHz pulse width modulated drive signal, 
13 volts = high = OFF, 0 volts = ON. The pulse width is set in 1/4 
microseconds increments. It is initialized to 0 and changed in small 
(1/4 microseconds) or large (2 microseconds) steps every 100 
milliseconds. At each step, the total delivered power is calcualted 
and compared with the power delivered at the previous duty cycle. If 
the power changed by less than 1.5%, and if no limiting conditions 
were encountered, small steps are used, otherwise big steps are used 
to speed up the process. 

If the power level was found to be constant or increasing, the next 
step is taken in the same direction as the last. If the power was 
found to be decreasing, the direction of step in duty cycle is 
reversed. Therefore, the duty cycle is adjusted to the maximum power 
operating point, and hunts there +/- one or two small steps, 
representing an operating point within +/- 1% of maximum power. 

This improved array control method is the subject of a patent 
application. 
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1.3.3 Load Control 

The battery is assumed to be loaded by up to 5 separate load busses, 
with separate voltage sensing, current shunts in the negative load, 
and relay control responsive to the optoisolator output 1-5 of the 
controller. These may in fact be auxiliary chargers as well as 
loads. 

Each load bus is also automatically monitored for excessive current, 
providing a built in circuit breaker function. Each load or charger 
bus can also be manually controlled from the keypad or the serial 
port. 

It is often desirable to use more energy if it’s going to be a sunny 
day. This may be to avoid short cycles of load useage or simply to 
increase energy useage efficiency. Therefore, between SAM and 
12Noon, if the sunlight level is high enough to provide at least 10% 
of the maximum charger current limit to the battery, all the battery 
corrected SOC levels for load shed and restoration are decreased by a 
constant preset SOC, called DELTA SOC. This allows loads to turn ON 
earlier on a sunny morning than would otherwise be the case. 

The MAC can perform a control strategy to allocate available energy 
into two different forms of storage. One of these is electrical 
energy stored in a battery. The other is a form of "product 
storage." This might be water stored in a tank, or thermal storage of 
cold in a refrigerator, freezer or ice stored in an icemaker. To use 
this capability, it is necessary to be able to measure the amount of 
product stored. This combination of trip points creates a set of 
four states of the controller, defined by the amount of product 
stored and the battery state of charge. By setting various values 
for the boundary parameters, various priorities can be placed in the 
use of energy. 
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1.3.4 CONTROL PANEL 

The control panel has a keypad for manual inputs, a 4-1/2 digit LCD 
display for selected quantities, a set of red, yellow, and green 
LED's for quick status summary, and an audio alarm. There is also an 
emergency switch located at the bottom of the unit which, when turned 
OFF, will turn OFF all array strings and loads. When turned ON, it 
will restart the program. 

The LCD display can be thought of as a multimeter which will display 
one of a menu of system parameters. The default condition is state 
of charge, and after a data dump each half hour, it returns to this 
parameter setting. It can also display any array string voltage, any 
charger output string current, (not the array current, but the 
converted output from that string at the battery voltage level), the 
delivered string power to the battery, the battery voltage current or 
power, any of five load bus voltages or currents or powers, the 
battery temperature, one other temperature (used here for freezer 
product measurement), the pulse width, the equalization charge 
needed, the system zero voltage and 4.00 volt reference level, the 
temperature corrected state of charge, the time of day, and the 
software version number. These are selected using the keypad. 

The keypad can also be used to change control functions. To do this, 
the correct password must be entered. Password accessible functions 
include setting a new load and restore thresholds for each load bus, 
setting initial state of charge and setting the manual control for 
each load bus ON or Off. 

1.3.5 Self-testing 

The autdmatic tesing of battery SOC and load currects is described 
elsewhere. Also, the unit can be placed in a test/cal mode where 
data is refreshed but the states of charge, max power tracking and 
load controls do not automatically change. This allows them to be 
manually set and measurements taken. For example, a fixed pulse 
width can be set from the serial port, or a lamp test can be 
performed. 

The display performs one more automatic test. If one of the charger 
power module output currents is less than a constant (lamp) below the 
average of all such currents, the "Continuity" segments of the LCD is 
turned ON. This means that one string of the array or one power 
module of the charger is either shadowed or broken. Examination of 
array voltages and currents will show the cause. 

Besides these external tests, the unit performs an automatic test of 
its RAM and ROM access whenever it is started up. When running, any 
error causing the program not to execute properly will result in a 
watchdog timer fault turning off all loads and the solar array and 
causing the green LED to go out. 


6 
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1.3.6 Serial Port Functions 

The manual test/cal mode was partially described in the previous 
section. However, with an RS232C terminal, much more extensive 
manual testing is possible. A standard debug monitor is implemented 
which can examine memory locations, insert bytes into memory, begin 
execution at a given memory location, insert or remove breakpoints, 
and download and program into memory. 

A data dump of all system voltages, currents, temperatures, switch 
positions and states of charge is sent to the serial port every half 
hour or whenever requested. A printer there will provide data 
logging. 

This powerful access allows many possible uses. The processor can be 
automatically tested during manufacture this way. A printer attached 
at the site can serve as a data logger. A telephone modem or other 
communication interface would allow automatic remote data logging or 
even, remote system control. 

The use of a small RS232C terminal by a repair technician allows 
fault isolation and diagnosis beyond the capabilities of the keypad 
and display, since small special test routines can be run. Software 
modification is greatly eased as well. 

TEST RESULTS AND CONCLUSIONS 

The battery charge control algorithm works as described. Its 
estimate of the fraction of capacity available is limited mainly by 
the accuracy of the battery's rated capacity at a given discharge 
rate which is supplied by the battery manufacturer. Long term low 
current operation is dominated by internal battery self-discharge, 
typically 1% to 2% per week, and current offset errors of 0.1% of 
maximum, which is often a similar percentage per week. This is 
corrected whenever the battery is fully charged, so that batteries 
cycled daily or weekly are not affected. 

The array control modes, both max power tracking and discrete 
switching, work very well and provide a nice tapered current 
finishing charge for a battery with very low water loss. The max 
power tracking with two step sizes is a real advance in the state of 
the art, as it provides a combination of more accurate tracking of a 
static max power point plus a faster acquisition time for a varying 
load or insolation. A chart comparing these performance figures is 
given here. 
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COMPARISON OF' MPC FUNCTIONS 


Previous State of the MAC 

Art Equipment 

Acquisition 3 sec 1 sec 

time +/-25S 

Max Dither, stable 3% 1% 

load 

Product 9 1 


This means that, for example, a volumetric pump or other slowly- 
cycling loads can be dynamically matched to the solar array with 
reduced need for expensive or lossly load-levelling mechanisms as 
large flywheels, batteries, etc. This opens up additional 
applications for the controller. 

Load management in response to battery state of charge is very good. 
It is free of the chattering and instability characteristices of many 
voltage-related load management schemes. The algorithm for product 
storage and apportioning energy to several types of loads works as 
expected. However, its sophistication makes it difficult for a user 
to verify that it is operating properly, and this may make it less 
popular than other approaches based solely on battery status. 
Instrumentation of the system using the keypad and LCD display is 
very effective. A permanently posted list of command codes on the 
unit near the keypad was found to be useful. 

Data logging via the RS232C terminal to an inexpensive printer is 
very helpful in village systems. Of less use in smaller 
applications, it is quite helpful for maintenance or fault diagnosis 
using a small hand held battery-powered RS232 terminal. The 
possibilities inherent in a phone coupler or other communicaions port 
for remote system control have not been explored, but they are 
potentially very interesting. The self-test functions of the 
controller are an effective means of allowing unskilled personnel to 
monitor a complex PV system. 

In conclusion, the microprocessor automatic controller works as well 
as, or better than, any existing PV system control equipment, and can 
be adapted to a wide variety of systems simply by plugging in an 
EPROM. This makes it a very attractive controller for PV systems 
where large size (over IkW), remote location or special control 
requirements justify this type of unit. 


8 
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2.0 DESIGN CONSIDERATION 

2.1 INDUSTRY NEEDS 

The photovoltaic industry is growing today at an annual rate of 
nearly 65%. This growth includes a varied mix of small simple 
battery chargers, pump drives, large sophisticated battery chargers, 
and utility interactive systems. As the cost of the PV module 
decreased, the fraction of the system cost represented by controls 
and engineering becomes more important. In order to allow the 
continued growth of volume and reduction of system prices, a 
controller is needed which is flexible enough for all applications 
while easy to apply without high recurring engineering costs. The 
microprocessor represents an opportunity to supply that need. 

In order to determine the range of system parameters required for a 
controller, a preliminary analysis of the near term PV market is 
useful. The following figure 2.1-1 indicates the breakdown of the 
1983-84 PV market, using a variety of various documented and informal 
sources, to ascertain the relative market share of various types of 
systems. The first rows of figures give the breakdown by system 
size, first a typical size, then a range of sizes, by half-decade 
logarithmic steps. The percent of power sold represents the fraction 
of PV kilowatts used in that size system. The percent of systems 
sold gives the fraction of the total number of systems regardless of 
size. A typical installed system price in $/watt is indicated for 
reference. 

The next section characterizes the controls, including power 
conditioning, for a PV system in terms of the dollar cost of controls 
at the OEM level divided the peak watts of PV in the system. These 
are divided into systems with Maximum Power Controllers (MPC) and 
those without. The difference represents the incremental cost of the 
MPC. The approximate fraction of systems without MPC's is indicated, 
and multiplied by the number of systems in each category, to give the 
number of controllers with and without MPC's in each system size 
category. This shows that the market for MPC type controller falls 
primarily in the 300 watt to 30 kW size range. The large number of 
systems at smaller sizes indicates the attractiveness of marketing a 
small, inexpensive controller which might be able to capture the 100 
W to 300 W market even without maximum power control. The high cost 
of controls below 100 watts size indicates that any controller will 
be hard to sell for such small systems. 

The last row of figures estimate the incremental value of an MPC 
for 1983 and 1986 PV systems. These estimates are based on the 
following rows of figures for typical system voltage, typical 
controllers and PV utilization, efficiency, and typical incremental 
PV array installed prices. Comparing these figures with the 
controller costs determines the utility of an MPC in such a system. 
Note that MPC's are probably worthwhile for systems over 300 watts at 
present and over 1 kW in 1986. 

Based on these results, it appears that a controller intended for the 
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% of power 
sold 

5 

10 

15 

15 
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15 
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10 

% of systems 
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25 

15 
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.38 
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Inst.$/watt 

cost 

30 
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25 

22 

20 

17 

15 

10 
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(INCLUDING POWER 
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0.30 
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50 
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240 

MPC effic. . 

82 

,87 
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.95 

.97 

.97 

.98 

.98 

No MPC 
effic. 

85 

.85 

.85 

.85 

.85 

.85 

.90 

.90 

Assume incremental 

PV array 

prices. 







$/W installed 

1983 198M 1985 1986 

10 8 6 5 


FIGURE 2.1-1 
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100 watt to 300 kW size range will' market well if it: 

1) includes MPC capability at an incremental cost of under 
$ .40/watt 

2) is also useful for battery management without an MPC 

3) costs less than $300 in a minimal configuration without the 
power electronics of an MPC. (The cost of a no~MPC 
controller for a 500W system) 

The needs of the industry can then be segregated into at least two 
different types of controllers. The very small, very inexpensive 
controller (typically one quad comparator today) for systems of a few 
hundred watts or less is not the same as the flexible, sophisticated 
unit for larger systems. The small controller is discussed later as 
the "zero option”. The larger controller can then be examined in 
terms of those characteristics which have a major affect on the unit 
cost. 


2.2 MAJOR COST IMPACT ITEMS 

2.2.1 System level items 

The items affecting controller cost fall into two categories; those 
which describe the system, and those which describe the controller 
itself. These are listed in Figure 2.2-1. System characteristics 
affect the controller by the number of analog currents or voltages to 
be measured, by the number of counter/timer functions, and by the 
power or energy level of those parameters. This last group impacts 
the sizing of relays, power converters, shunts, and terminals in an 
obvious way which is separate from the control function itself; and 
is easy to design as required. In particular, any inputs or outputs 
of the control system which are continuously variable rather than 
switched are most expensive because they require either A/D or D/A 
converters, analog multiplexers, or counter/timer functions. Extra 
array measurements, maximum power controllers for the array, and 
variable loads (such as motor drives) are in these categories. Also, 
since battery control is the most complex function of the controller, 
dominating its accuracy and speed requirements, the number of 
batteries to be controlled independently is a major factor. 

The effect of controller characteristics on cost requires further 
description of these tasks. Figure 2.2-2 lists major control 
functions. 

2.2.2 Battery Control Considerations 

The basic algorithm to be used for battery state of charge (SOC) 
estimation will be ampere-hour integration. Total ampere-hours into 
and out of the battery will be used to estimate change in SOC. 

Beyond this, a variety of checks, adjustments and corrections might 
have been used. 



DESIGN CONSIDERATIONS HAVING STRONG EFFECTS 
ON THE DESIGN OBJECTIVES AND COSTS 


I. PHOTOVOLTAIC SYSTEM CHARACTERISTICS 

1. Photovoltaic array size 

2. Type, number and total energy of storage elements 

3. Type, number and total power of variable controlled loads 


II. CONTROL SUBSYSTEM CHARACTERISTICS 

1. Array control 

2. Battery SOC algorithm 

3. Load management 

4. Product storage load management 

5. Requirement for independent manual control override 

6. Manufacturability 

7 . Adaptability 

8. Maintainability skill, test equipment and MTTR 

9. Reliability - MTBF 


Figure 2.2-1 



Major Functions of the Controller 

1. Battery State of Charge estimation 

- amp hour accumulation 

- temperature compensated voltage limits 
and float voltage 

- MFC inhibit 

- automatic charge equalization 

2 . Maximum Power Controller 

- int»ut filtering 

- comparison and duty cycle stepping 

- limits 

- direct digital PWM control 

- output buffering 

3. Load Control 

- variable load setting 

- multiple fixed loads 

- response to SOC 

- backup generator control 

- product storage status response 

4. User Service 

- keypad input scan 

- parameter settings 

- multimeter readout 

- SOC readout 

- diagnostic readout 

5. Self Test Capability 

- Array and battery and load monitoring programs 

- Self monitoring programs 

6. RS232C Interface 


Figure 2.2-2 
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The coulombic efficiency of the battery is not 100%. As the battery 
becomes more fully charged, this value drops from near 100% until the 
battery is fully charged and equalized and the coulombic efficiency 
reaches zero. One correction then is to discount some fraction of 
charging current based on SOC. This was implemented. 

The battery's self-discharge rate represents internal reduction of 
SOC without external current flow. This depends on battery 
chemistry, temperature, and age. Therefore, some estimate of 
internal self-discharge rate based on temperature might be used as an 
approximation. However, this was not included in the present unit 
because it is so dependent on manufacturing parameters of the 
battery. 

Battery terminal voltage depends on age, temperature, SOC, rate and 
past history. However, at full charge and at full discharge, the I-V 
characteristic of the battery can be well established, with a 
suitable temperature correction. This means that at a temperature- 
corrected float voltage, the SOC is corrected to 100%, or at a 
minimum voltage the SOC is corrected to 0. Another alternative is to 
measure the current drawn at the float voltage at a given temperature 
and extend the charge cycle (lower the calculated SOC) if it is too 
high. This last was not implemented because it again is very battery 
dependent. The first alternatives were implemented, however. 

Equalization of cells is done as a voltage-limited (temperature 
compensated) charge based on a number of ampere-hours required equal 
to a fraction F of ampere-hours discharged from the battery. After 
the completion of equalization, the charge may have been terminated 
to save water, or a lower voltage trickle charge may might be 
maintained. Based on our experience with systems, the latter was 
chosen. 

An estimate of the time to next required battery watering of amount 
of water required could be made by the processor. This would be 
somewhat inaccurate, but might be of some use in warning of required 
maintenance before actual failure. This was not implemented. 

The battery state of charge is defined to be the fraction of 
nameplate ampere-hour capacity which can be delivered at a nominal 
discharge rate before dropping below a voltage threshhold (typically 
1.75 volts per cell). This changes with the battery temperature. (If 
the value is corrected for temperature, the result may exceed 100% on 
a warm day.) This value was chosen for load control functions, and 
for front panel display of system status. 

Estimates of state of charge by combining voltage, current, and 
temperature using a ROM look-up table at intermediate SOC level has 
been found previously to be inaccurate during charging periods, and 
was not used. Another approach, modelling the battery internally by 
a series of coefficients representing internal circuit elements, has 
been proposed by researchers at Tel Aviv University. See for example 
"Measurement of the State of Battery Charge using Improved Loaded 
Voltmeter Test," E. Ofrey and S. Singer, IEEE Trans, in 
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Instrumentation and Measurement, Vol. IM-31 No. 3, pp. 154-158, Sept. 
1982. This approach was found to give good long term results, but 
only after a particular make and model of battery was characterized 
extensively. Since this implies a practical limit in the flexibility 
of the controller, this approach was not utilized either. Instead, a 
current integration (amp-hour meter) approach corrected for coulombic 
efficiency based on state of charge was used. This is in turn 
corrected if it exceeds the extreme temperature-compensated voltage 
limits expected for that battery; a much easier parameter to specify. 

To measure battery current within half the rate of the internal self- 
discharge current, it was necessary to resolve to the nearest 550 
hour rate. This compares with typical maximum charge/discharge rates 
of 4 hours typically, or 1 hour in an extreme case. Therefore 
resolution within 9 bits was required. Since the full scale range of 
the shunt may not correspond to the maximum rates (by a factor of 2 
or 3). resolution to 10 bits minimum was required. 12 bit resolution 
would be nice but not absolutely necessary. If 100 millivolt shunts 
are used, this implies offsets near 25 microvolts will be visible. 
Therefore, the design should strive for 12 bit or 25 microvolt 
resolution of battery currents, with only 10 bits or 100 microvolts 
actually required. The use of a 10 bit plus sign A/D converter and 
4X signal averaging was selected. 

One major expansion of the controller’s task would be to separately 
calculate SOC of multiple parallel battery strings. This takes up 
some extra RAM, processing time, and implies a higher level of system 
costs to implement for equalizong strings separately. However, 
reliability and cost savings warrant the added complexity in some 
cases. This was not implemented in order to keep controller cost 
down. 


2.2.3 Array Control Considerations 

The PV array must be controlled under the following circumstances: 

1. If a battery is used and is fully charged, to avoid excessive 
water useage. 

2. To avoid excess voltage on the load. 

3. To allow the load(s) to be turned off if the array dconnects 
directly to it, as discussed under load control. 

4. To allow a portion of the array to be safely repaired while 
the remainder of the system is running. 

5. To avoid discharging the battery at night if no isolation 
diode is used. 

6. To protect the array in case of fault. 

Typical means of array control include: 

1. Series contactors or switch elements, usually with series 
diodes in all but some low voltage configurations. 

2. Parallel switch elements scroll the solar array, with a 
series diode between array strings and the battery. 
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Switching DC-DC converter elements between array and battery 
usually providing maximum power control. 

The control signals required by these schemes are different. Series 
or shunt regulators require a digital signal for each array string. 

A parallel shunt element might require no signals, or might have a 
digital input to modify the set point voltages for equalization. The 
switching converter requires a pulse width modulated square wave at 
the switching frequency, typically 2kHz to 100kHz being extreme 
values and 20kHz most common. 

Instrumentation of such systems over and above what is needed for 
control, would normally provide one voltage and one current 
measurement for each array string. Since the instrumentation 
provisions are the same, design of the controller must concentrate on 
providing signals for control in the various cases. The first two 
cases (series or parallel) require the same signals. Since 
dissipative shunts are cost effective only in small systems, the 
third case has no impact on microprocessor system design. The last 
case is very well matched to microprocessor systems capabilities. 

Note that many systems are cost effective without built -in 
instrumentation, but with provision for multimeter readings via test 
points. 

Therefore, the most useful way to deal with the series, shunt and 
switching converter array control options was to provide a different 
ROM sub-program for the same basic system design. The maximum number 
of independent subarrays to be controlled must be set and 5 
optoisolated or 10 direct coupled output signals was chosen as good 
number. This number of optoisolated output signals must then be 
supplied, and could be used for either array inputs or load busses 
depending on system requirements and ROM programming. 

Next, considering the option of maximum power control, the ability to 
distinguish small changes in the combined output voltages and current 
generally limits maximum power tracker performance. Therefore, 
careful treatment of the signal to noise ratio and the filtering of 
the input signals is important. This was carefully analyzed during 
design. 

Typically, the power is an insensitive function of the duty cycle 
near a maximum. Therefore, a 2 % change in duty cycle F produces a 1% 
change in output power. In the resistive load case, Vo and lo may 
each change 1/2%. Therefore, to find the max power point within 1%, 

6 bit resolution of duty cycle F and 8 bit resolution of V and I are 
required. Since the system must run at a fraction of full scale, an 
extra 3 bits is needed. Therefore, use of a 10 bit plus sign A/D 
gives adequate resolution. Filtering must recognize the presence of 
20kHz and its harmonics as switching noise, and must produce the 
cleanest differences possible at 100 msec intervals. This means 
averaging a number of samples in the 100 msec window. Four samples 
were averaged. 

Timer capability for 8 bit duty cycle resolution requires, for 20 kHz 
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carriers, a timer speed of 5 mHz. 'This is fast for CMOS, so perhaps 
a 7 bit capability would suffice, or a non-CMOS timer could be used. 
The non-CMOS timer was implemental. 

It is necessary to recognize when some other limit is operating to 
disable the max power tracker. In such a case, no change in output 
occurs except noise, and the duty cycle should then move toward a 
nominal value or remain fixed. Remaining in a "dither" pattern was 
chosen. 

Ability to manually move the duty cycle up or down can be useful for 
array string testing, although it is not often required in an 
operating system. Therefore a test/cal mode was implemented. 

Based on our experience, it is felt that up to 10 power elements 
should be driven by one MPC controller, each with a separate buffered 
output. These may be assumed to have their outputs in parallel, with 
separate subarrays. Therefore, 10 buffered outputs, all with the 
same pulse width modulated signal were provided. 10 DC currents and 
one output voltage were sampled. 

With present production power modules rated a 500W, TriSolarCorp 
could handle up to 5 kW with one controller. Larger systems could 
use multiple controllers or a larger power module (perhaps 3 to 5 kW) 
could be developed. 

T+iere are two basic cases in our experience when it is useful to have 
two max power controllers (MPC) operating from the same solar array. 
The first occurs with a shunt wound DC motor driving a pump or other 
device. The field winding requires power for start-up and so must 
have high priority on solar input from a portion of the PV array. 
After 30% sun or so, the field winding is fully excited and the rest 
of the bower from this portion of the array can be used by the 
armature. The field usually represents 3% to 5% of the total power 

dissipation at full load. Use of separate arrays and MPC's results 
in waste of 6% to 10% of the system output at full run. Idealy, this 
can be recovered by using extra DC-DC converters to divert some power 
from the field portion of the array to the armature. 

A second instance occurs when a water pump and battery charger are 
combined. The battery may be small and ideally, after the battery is 
charged, the water pump could be used for excess energy use. 

Separate arrays waste the PV output to the battery when it is fully 
charged. Running the pump off the battery requires a bigger battery 
and loses energy in the battery. 

Ideally one set of DC-DC MPC drives would power the field of the 
motor or charge the battery until it reached a limit. Then another 
set of MPC drives would pull extra energy from the same PV strings 
for variable load use. 

Each maximum power controller function added to the control unit 
requires whatever power conditioning elements are needed, extra 
output V and I sense lines, and extra PWM timer, an output on-off 
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control bit, a few bytes of R'AM, and a small anount of extra ROM, 
plus the program execution time on a 100 millisecond loop. Since the 
power conditioning can be used as needed, the inputs and timer are 
the biggest penalty to a minimal control element configuration. For 
the prototype, the second MPC was not implemented, but the provision 
of an extra timer was made to allow later implementation. 
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2.2.4 Load Control Considerations ' 

A variable load would be controlled by a proportional analog signal 
of 0-10 volts. Therefore, one such output was provided, with 
programmable direction, and SOC programmable set points for load 
shedding and load restoration. Resolution is not important since 
only approximate energy useages need to be controlled. 

Most loads are not continuously power controlled and up to 5 discrete 
outputs should be provided for. These would be 1 bit isolated 
outputs, with programmable SOC "ON” and SOC "OFF" set points. These 
could also include back-up generators or other such devices. 

Manual override capability is probably best placed in the loads 
themselves rather than in software. However, for self-test purposes, 
artificial counting up and down of the SOC control signals should be 
possible. Therefore, a manual SOC setting capability was included. 

At least one output circuit for latching relay drive should be 
provided. However, this was left for external hardware rather than 
internal software. 

Multiple variable DC loads must be assumed to be in parallel, 
otherwise the number of PWM counters becomes unmanageable for a 
single CPU controller and controller networking is required. 

AC loads, to be variable, would require a variable voltage' and 
frequency inverter. Drive signals for the poles of such an inverter 
might be useful, but might be used for this function only when it is 
needed, for variable speed AC pumps or compressors. These were not 
included. 

Product 'storage can occur in a number of forms. Examples of this 
are; 


1. Water tankage (pumping). 

2. Ice making (refrigeration). 

3. Phase change thermal storage (refrigeration or heat pump). 

4. Fertilizer making. 

5. Water heating (resistive). 

6. Salinity (water desalination). 

Because of the diversity of types, the control interface must be 
relatively simple to be standardized. Typically, the product storage 
system must indicate when it is full and when it is empty. Provision 
for this can be flexibly accomodated with two relay contact inputs, 
one normally closed and one normally open. Either one in the 
abnormal state should cause the PV system to turn OFF, under the 
assumption that product storage capacity has been reached. In most 
oases, a pair of level switches or thermostats can provide the 
desired signals. The capability of accepting other analog inputs 
would be provided in hardware anyway. One algorithm for sharing 
power between an analog measured product and a battery was be 
developed. 



FINAL REPORT 


Output to load control may have to operate over hundreds of feet in 
electrically noisy environments. Grounding of such signals can cause 
problems for the control system. Therefore, all discrete load 
control signals were optoisolated. In low cost applications, the 
optoisolators can be omitted to avoid excessive cost of unnecessary 
options. (This same consideration applies to discrete array control 
signals for series or shunt regulated systems. The same outputs can 
be used, with a programming change.) 

Predictive load control algorithms must take into account primarily 
the state of charge of the battery, and secondly the time of day and 
present insolation. This allowed correction of the load shed 
threshold to a perhaps 10% lower value if the time were 8 to 11 AM 
and the array current was 20% of the maximum, for example. This 
would avoid innecessary cycling of loads. Further use of predictive 
control requires algorithm development and field experience which is 
a good subject for research, but was not currently available for 
implementation in this controller. The controller will facilitate 
the data logging required to obtain parameters for evolutionary 
development of these methods. 

2.2.5 User Service Considerations 

As a minimum, any controller must allow the user to turn the MPC ON 
and OFF, and display the battery status. Given the data available to 
this controller, it also provides readouts of all sampled voltages, 
currents, or temperatures. It also provides alarm functions for 
system malfunctions (for example: output over voltages, output over 
cur rent, motor over temperature, array string output zero for more 
than 24 hours) and perhaps some diagnosis of problems (power module 
shorted). Most alarms are visual, with provision for an audio option 
for critical failures. 

Also, parameters of the system might to some extent be field or user 
reprogrammable to allow a single stock controller design to be 
produced for distribution. These parameters might include state of 
charge, number of power modules or array strings, motor voltage, 
battery voltage or capacity. The use of a back-up battery for 
internal memory or electrically reprogrammable ROM (EPROM) becomes 
necessary for this. It was decided to provide manual reassignment of 
load priorities, but all other parameters were fixed in EPROM. 

The interface itself waschosen to be a low cost ($5 to $10) membrane 
switch keypad for input, and a 4 1/2 digit display for output. A 
buzzer or loudspeaker would be optionally plugged in. These features 
were mounted on an inner hinged panel, behind the weatherproof NEMA 
front panel and in a location protested from user contact with any 
live parts. 

This also allows initiation of self-diagnosis routines from the 
keypad, which could test all elements of the processor and 
interfaces. 
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Further diagnosis might be done via' an RS-232 port. This port could 
also provides for data logging of the signals sampled by the 
processor. These included array string input voltages, output 
voltages, and MFC power module output currents. From our experience, 
these facilitate fault diagnosis and isolation as well as permitting 
delivered power and efficiency calculations. 

2.2.6 Self Test Considerations 

At the highest level, the processor tests the solar array strings to 
determine if one is weaker than the other. It, warns if the battery 
is too deeply discharged. It announces if a load draws much current. 

At the next level, the controller tests itself. A test of RON, RAM, 
and all output audible and visible alarms is performed on demand. A 
watchdog timer checks of the processor is running at all times. 

To allow both production testing and field repairs, an RS-232 
interface and a small monitor program is useful to exercise the data 
collection, processing, output control, and timing functions of the 
controller under manual control. With only the keypad input and LCD 
readout, a more limited manual checkout of the system and the 
controller is possible. This simply displays voltage and current on 
demand, and allows manual unit turn ON and OFF, plus a scan of all 
parameter settings in the controller. 

A standard hexadecimal 16 keypad suffices for the development systems 
with two preliminary letter keystrokes for function and numbers 0-9 
for string or parameter identification. In production quantities, 
the letters could be replaced by more explicit labels of the 
functions. 

2.2.7 Other Considerations 


In addition to the these functional requirements, the need for a 
product which is easily reproduced without custom drawings for each 
application is important. Also the adaptability of the unit to a 
particular system without large numbers of selector switches, ports, 
jumpers or custom trimmed resistors is vital. Extensive use of 
EPROM, for system parameter and algorithm specification was chosen as 
the most viable approach. The use of replaceable modules at the 
board level into the unit, was found to be necessary for user 
acceptance in locations where PV is to be used. 

Finally, the unit has to be very reliable if it is not to compromise 
the inherent advantage of reliable electric power which makes PV 
systems attractive. This implies use of proper temperature range 
components and minimization of parts count. 

2.3. OPTIONS DEFERRED 

In designing the controller, a number of decisions were made which 
might be re-examined at some future date as component technology 
changes. These are described here to facilitate such future project 
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planning. 

2.3.1 “Zero Option” 

In looking at the market analysis for PV controllers, it appears 
that there may be a place for a very inexpensive (well under $100) 
controller without many of the features needed in large systems. 

Such a controller would be simply a battery regulator, with a single 
array input and a single load output. It would be intended for 
systems from 100 watts to IkW peak, where the site access cost for 
battery maintenance or replacement would make state of charge control 
worthwhile. It would have no instrumentation or data logging, 
capabilities, no sequential load shedding, no maximum power point 
reacking, and would be designed only for 12 or 24 volt batteries. 

However, it would provide a readout of battery state of charge based 
on ampere-hour accumulation and would provide better battery charge 
control than the ten dollar voltage limiter with temperature 
compensation which would compete with it. Such a controller would 
require very little memory (RAM or ROM) and could be implemented with 
an 80C48, 146805, or equivalent processor. Inputs for voltage, 
current and temperature of the battery would be adequate. Latching 
relay drives would be appropriate for input and output. 

The economics of such a controller are marginal at present. In the 
future, sufficient volume (several thousand per year) would allow a 
masked-ROM memory and an inexpensive 8 bit multiplexed input, 
resulting in parts costs under $40. Until such time as this market 
becomes better defined, the viability of such a product is not clear. 
However, a specification has been generated for future reference. 

The concept is labelled the "Zero Option" because it is not one of 
the five recommended options for the next phase of this contract. 
Figure 2. 3. 1-1 gives these specifications. 

2.3.2 Larger Power Stages for Maxpower Control 

The TriSolarCorp MFC power modules available at present are rated 
500W each. The control of systems larger than about 5kW requires 
that more than 10 such power modules be used. This can be 
accomplished using the present MAC microprocessor controller only if 
not all of them are monitored, or if more than one MAC be used, or if 
relays instead of MFC power modules are used. A better solution is 
to develop power modules of near 5kW power rating. This requires 
interfacing to the MAC with a pulse modulated waveform of the proper 
frequency, since 20K HZ implemented at present may be too fast for 
larger devices. Also the dynamics of the control functions must be 
compatible with the slower filters of a larger power module. 

This development was beyond the scope of the present contract. 


2,3.3 Multiple MFC Control 

In many systems more than one max power control function is needed. 



SPECIFICATIONS FOR 
✓ 

Array Voltage: 

Array Configuration: 

Array Control : 

Single Ended Inputs: 

Differential Input: 

Control Inputs: 

Battery: 

Battery SOC Control: 

Battery Voltage Limits: 

Control Digital Outputs: 

Manual Entry or I/O: 

Display: 


ZERO OPTION" CONTROLLER 
+10. OV to +60. OV 
Single input 
Discrete ON/OFF 

Battery voltage, battery 

temperature sensed by 10k ohm 
thermistor 

+100mV battery current shunt 

Relay contact closures, One NC, One 
NO 

12V or 24V Nominal, 10 to 10,000 
• ampere-hours, required for 

operation 

Ampere-hour accumulator, accuracy 
+ 105t, precision +2$ 

Maximum absolute limit, maximum 
temperature -compensated limit, 

minimum absolute limit 

One for array, one for load, 
latching relay drives 

None 

Battery SOC, 2 1/2 digits, LCD 


FIGURE 2. 3.1-1 
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since more than one power flow path from an array to a load must be 
controlled. No extra hardware in the CPU would be needed to 
implement the feature, but extra power conditioning hardware would be 
needed as well as appropriate software. This was not implemented in 
the prototype since no specific use was foreseen at present. 

2.3.^ Variable MPC Control 

The ability to drive standard sumersible AC motors for pumping 
applications would enhance the controller. However, the relation 
between an AC motor and its variable speed drive is particularly 
intimate in terms of protective features and optimal drive 
strategies. 

Implementation of this function was left for a separate unit, with a 
simple interface to the MAC controller via an analog control voltage 
0-10V F.S. This task is well worthwhile when resources are available 
to support it. 

2.3.5 Multiple Battery Strings 

If a large system consists of several parallel-connected battery 
banks, it is possible to compute the state of charge of each one and 
check that each is sharing the load. However, this is not critical to 
the PV system control task and so was not implemented at this time, 
since it impacts the size and speed of the controller. 

2.3.6 System Topologies 

The most fundamental choice in applying a microprocessor controller 
to large PV systems is the overall topology. How many controllers 
will be used, and how will they communicate? Three basic topologies 
were studied. These are described as follows: 

Distributed Controller 


The distributed controller is conceptually a number of independent 
microprocessors, each performing a different function in the overall 
system and each located with the equipment it controls. For example, 
in a village power system some control elements might be array 
controllers or max power controllers for separate subarrays, another 
might perform battery management, another control load management 
functions, and another might perform data logging and display 
functions. Only a small amount of slowly changing information would 
be exchanged between them via a bus structure of some kind. Any one 
controller could function in a backup mode without any information 
from other controllers. 


Star Controller 


In the star configuration, a master controller operates the central 
elements of the system and communicates with remote slave units ar 
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the ports of the "star". These slave elements are simpler, more 
sprcialized units and communicate only with the master controller. 

In a village power system, for example, the master unit might perform 
battery and load management and data logging functions while the 
array controls or max power controllers were slaves. Diagnostic 
displays might be divided among the elements as required. 

Information on battery status would flow from the master unit, and 
array status would return to it. Backup operation would require 
manual control of the battery and loads. 

Central Controls 


In a central control scheme, all control functions reside in one 
controller with no processor or "smart" controls in any other place. 
In a large village system, all array switches or max power trackers 
and loads have their operating states set by the central controller. 
All data logging and most of the instrumentation would also be 
centralized. This configuration allows the most complex algorithms 
since a;; data is available for all functions. It also provides the 
least redundancy and backup capability, unless the central controller 
has it built in. 

Assuming a microprocessor of even minimal complexity at each mode, a 
trade-off study showed that the central topology was the least 
expensive for all but the smallest systems. This was basically 
because the cost of memory, power supply, enclosures, and so on was 
too high for very small units of the distributed or star networks. 
Therefore, the central topology was pursued as the basic requirement 
for the MAC controller. 

However, it should be noted that the MAC can be used in either 
distributed or star configuration under some circumstances. 

If a large system required independent operation of several parts for 
higher reliability, several MAC units could be operated 
independently. No information would be exchanged between them, 
unless further development of a multi-station RS232C bus were 
completed. 

Also, if a system had a number of "dumb" controllers such as the low 
cost TriSolarCorp BCR unit, each of these with its subarray could be 
treated as a discreet-switched string and controlled and monitored by 
a sequentially switched segmented array control, a very good way to 
handle large low voltage DC systems. The MAC would provide 
everything except max power tracking for such a system. The three 
basic topologies are diagrammed in Figure 2. 3.6-1. 

As part of the trade-off of system topologies, a Failure Mode and 
Effects Analysis (FMEA) was done for each option. Figure 2. 3.6-2 
shows the system level failure modes of the unit and their results. 
Figure 2. 3. 6-3 takes these failure modes and compares the impact of 
each of failure on overall system operation. As is easily seen, the 
impact of distributed system failures is far less than star system 
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FIGURE 2. 3, 6-1 




























FMEA, SYSTEM LEVEL 

Function Distributed Star Centralized 

Lost 


Array Control 
Partial 

Reduced output 
until scheduled 
maintenance 

Reduced output 
until scheduled 
maintenance 

Reduced output 
until scheduled 
maintenance 

Total 

Greatly reduced 
output until 
scheduled main- 
tenance 

Greatly reduced 
output until 
scheduled main- 
tenance 

Total shutdown 
controller re- 
placement 

Battery Control 

manual operation 
modular replace- 

manual operation 
master unit re- 
placement 

totally manual 
operation, con- 
troller replace- 
ment 

Load Control 

Manual load 
operation, mod- 
ular replacement 

Manual operation. 
Master unit re- 
placement 

Totally manual 
operation, con- 
troller replace- 
ment 

Instrumentation 

Operational , sched- 
uled maintenance 

Operational, 
scheduled mainte- 
nance 

Manual operation 
Controller re- 
placement 

Data Logging & 
Communications 

Manual operation, 
modular replace- 
ment 

Manual operation, 
modular replace- 
ment 

Operational, 
scheduled main- 
tenance, modular 
replacement 

Self Test 

Operational, 
scheduled mainte- 
nance 

Operational, 
scheduled mainte- 
nance 

Operational, 
scheduled mainte- 
nance , controller 
replacement 


FIGURE 2. 3. 6-2 
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FMEA IMPACT CHART 


ANY ONE ELEMENT: FAILURE DISTRIBUTED STAR 


Power Supply 
Low 
High 

A/D Converter 
Calibration 
No output 

Display and Interface 
Partial 
Total 

Array Control 
Partial 
Total 

UART/RS-232 

Total 

CPU & Memory 
Total 


1 2 

1 2 

1 1 

2 2 

1 . 2 
2. 3 

1 1 

2 2 

2 .2 

1 or 2 2 


Current Meas. Max or Analog Mix 
Partial 1 1 

Total 1 2 


NOTE: 1=degraded performance, scheduled maintenance 
2=manual operation until maintenance 
3=total failure 
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3 

3 


2 

3 


2 

3 


1 

3 


1 


3 


2 

3 
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failures, which in turn are less th-an central system failures. 

2.3.7 Other Processors 

The choice of processor is very fundamental to the realization of the 
controller. Based on the previous decisions, we needed a processor 
with 8-bit data bus, 16-bit address bus, and instruction times below 
5 microseconds. A list of these are attached in Figure 2.3.7--1. In 
addition, memory requirements were estimated to be 2K of RAM and 12K 
of EPROM. 

This was too much for the chips with on-chip memories which were 
available for the "zero option". Also, using a chip with all address 
and data lines available allowed system expansion for larger 
applications. 

Major considerations then became power level (CMOS preferred), 
availability, support, and cost. These reduced the field to two 
major competitors, the national NSC 8Q0 and the various suppliers of 
the 65C02. The main attractions of the NSC800 were availability 
and low power. In particular, the modular MA2000 version of the 
NSC800 looked attractive as a compact package. However, availability 
of the MA2000 in the time frame required was a problem, and the cost 
of the NSC800 in any form was higher because of the interfacing 
needed for its address and data busses. Development support for the 
65C02 was more available at the facilities which needed it, and the 
cost was very low, the CPU only $10 in large quantities. After 
evaluations of samples from both GTE and Rockwell, this bacame the 
choice for the project. The availability of NMOS versions of most of 
the family at lower cost for breadboarding was also useful. 

Analysis of the cost of the 65C02-based processor, which is suitable 
for any of the three geometries and can meet all the preliminary 
design requirements, shows that its hardware cost, in small quantity 
production, in materials alone will exceed the $300 cost target, 

'meant to include labor and overhead as well. This problem motivated 
a careful look at lower cost alternatives which could be used in some 
topologies (perhaps as a peripheral unit of a star configuration) or 
with reduced capabilities. The number of analog inputs and load bus 
controls, plus the UART support requirements, were the driving force 
behind the processor choice. Therefore, a lower cost alternative was 
generated which approached the operational requirements of the system 
with less input and output. 

The dramatic cost reduction possibilities lay in the use of a single 
chip computer with inboard EPROM. The chip selected for closest 
approach to the 65C02 in instruction set and largest memory capacity 
was the MC1468795G2. This has 2106 bytes of EPROM, 112 bytes of RAM, 
internal timer, 32 I/O lines, bootstrap programming and is plug 
compatible with a masked ROM version for future cost reduction in 
larger quantities. It combines CMOS power levels with a versatile 
instruction set. Its limitations for our application are expected to 
be the number of I/O lines and the amount of ROM. Its advantage is a 
cost reduction of almost a factor of two. 



COMMERCIALLY AVAILABLE CMOS HICROPROCESORS WITH 8 BIT WIDE DATA PATHS AND INSTRUCTION TIMES BELOW 5 MICROSECONDS 
o 


anufacturer 

DEVICE 

1. MEMORY (B) 

2. RAM (C) 

3. ROM (D} 

INSTR CYC 
MIN/ MAX (E) 

INSTR # 

INTERRUPT 

LEVELS 

REGISTERS 

MEMORY 

MAPPED 

I/O 

ADDITIONAL FEATURES & COMMEt." 

OMMOnORE 

MCS-65COX 

HCS-65C1X 

64K 

0.5/3. 5 ' 

56 

1 

ACCUM. 

X, Y 

STACK PTR 

YES 

1. 6502 NHOS C0MPATIBLEU1CS-6 

2. HIGH LEVEL LANGUAGE SUPPOR 
EXTENSIVE 


ITACHI HD6501 ,b4K 2/12 82 1 ACCUM A, B YES 1. 6801 NHOS COMPATIBLE 

128 BYTES/ X, 2. MULTIPLY INSTRUCTION 

2K BYTES STACK PTR 3. 31 I/O LINES 

4. DOUBLE PRECISON OP CODES 


ITEL 


OTOROLA 

ITACHI 


MD68SC02AC 64K 

128 BYTES 


2/5 


72 


1 ACCUM A, B YES 

X, STACK PTR 


1. MOTOROLA 6802 NMOS COHPATI 

2. IV. STANDBY CAPABILITY 
3-7V OPERATION 


HC146805E2 

MC146805C2 

HD6305 


8K 

112 BTYES 


2/4 




Q 


61 


T3 
O S 
O > 

53 r" 


lO 13 

r°° 


1 

IRQ 

TIMER 

SWI 


ACCUM, X 
STACK PTR 


YES 


.1. 32 I/O LINES 

2. TIMER 

3. 20HW ACTIVE, 1MW STANDBY 

4. 3-6V OPERATION 


NSC 800 


64K 


1 . 6 / 9*2 


158 


14GP 


YES 


1 . Z 80 INSTRUCTION SET 
& CODE COHPATABILE 

2. SUPERSET OF 8080/8085 SET 

3. HIGH LEVEL LANGUAGE SUPPOR 
EXTENSIVE 


1C 

:i 

■:c 

)SRIBA 

INS80C48 

IN80CX48 

MPD80C48 

TMP80C48P 

4K 

64 BYTES 
IK BYTES 

ITEL 

80C49 

4K 

:c 

MPD80C49 

128 BYTES 

'I % 

THP80C49P-6 

2K BYTES 

)SHIBA 



'EHSTL 




2.5/5 


1 .4/2.8 


36 1 16GP 

37 ACCUM 


NO 1 . SUBROUTINE NESTING LIMITEE 
8 LEVELS 
2. 27 I/O LINES 
3* TIMER 

4. 8048 NHOS COMPATIBLE 

5. NO HIGH LEVEL LANGUAGE SUI 


80 1 16GP NO 1. SUBROUTINE NESTING LIMITEI 

8 LEVELS 
2. 27 I/O LINES 

3* timer 

4 . NO HTP.H T.PUfl. r AMrilAPc- en- 





COMMERCIALLY AVAILABLE CMOS MICR0PR0CE50RS WITH 8 BIT WIDE DATA PATHS AND INSTRUCTION TIMES BELOW 5 MICROSECONDS CCON’T) 


rOSHIBA 

ISC 

)KI 

TMP80C5GP-6 

4K 

64 BYTES 

2.5/5 

96 

1 

16GP 

ACCUM 

NO 

1. 8059 NMOS COHPATIBI 

2. 27 I/O LINES 

3. NO HIGH LEVEL LANGl 
SUPPORT 

\Ck 

1805 

64K 

64 BYTES 

4/6 

113 

1 

16GP 

NO 

1 . 8 BIT COUNTER-TIME! 

2. SOME HIGH LEVEL LAI 
SUPPORT 

■flTERSIL 

IM6100 

4K 

2. 5/5. 5 

81 

1 

ACCUM 

MQ 

NO 

1 . PDP-8 INSTRUCTION £ 

2. 4V TO 11V OPERATIOr 

3. 12 BIT DATA PATH 


lOTES; A) All units have expansion l/O capability 

B) Memory direct addressing capability 

C) RAH on CHIP 

D) ROM on CHIP 

E) In microseconds 
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To allow use of this chip, the array string currents are summed prior 
to sampling. The individual array string currents and voltages, if 
needed for instrumentation, must be switched manually to a metering 
input of the processor. Also, the two (not five) output bus lines 
are not measured automatically, although these too could be manually 
metered the same way. Only one PWM output is supported, with no 
analog output signal. Finally, the limited I/O of the chip will not 
support a UART for RS-232 linkage in addition to its other tasks. 
Communication via two dedicated digital inputs and one analog input 
is provided. Self test functions are minimized. 

However, with these reductions, the processor can perform the key 
array control, battery charge control, load management, 
instrumentation, and self test functions in the system design 
requirements. The unit would be able to meet the requirements of the 
many small applications at a competitive cost, with the sacrifice of 
more complex system capability. 

To meet more complex system requirements, the small processor option 
could be used in the following ways: 

1. As a peripheral unit of a star configuration, with the two 
digital and one analog input lines to the hub element, the unit 
works. The central unit might be the 65C02 based controller or 
another small controller configured with no analog inputs but UART 
interface for data logging and a sinplifies link to the peripheral 
units. 


2. As a multiple processor central unit, with one major function 
for each chip. 

As a distributed processor element, the limited I/O capability makes 
the small processor option unfeasible. The small processor was not 
implemented in the prototype. 

2.4 CONTROLLER SPECIFICATIONS 


Having selected the important functions of the MAC unit, and deferred 
the options not to be included now, the requirements for the unit can 
be summarized as a specification. This is done in Figure 2.4-1. 


Array Voltage 


Array Configuration 


Array Control 


Tracking Accuracy 


+10. OV to +18. OV or 
+40 to +300. OV, 

Input power under 5 watts 

1 to 10 string 

40 to 500W per string 

Discrete string ON/OFF or maximum 
power control by Pulse Width Modulator 
(PWM) down converter 

Within 1% of maximum output power 
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Control PWM Interface 12.5V (4-1V/-.05V) pulse width modulated 

20kHz CMOS lo§ic level, up to 10 buffered 
outputs which can be connected to either 
one of 2 independent PWM drivers or are 
usable as 10 separate discrete control 
signals. 

Single Ended Sense Inputs +/- 4V DC full scale, +/~ 2% accuracy, 

10k ohm source impedance maximum. 16 
voltage channels plus 2 thermistor 
channels 

Differential Inputs +/- lOOmV full scale, +/- 2J accuracy, 

+/- 2V common mode maximum, IK ohm 
source impedance maximum, 16 channels 

Control Inputs Two contact actuated inputs, one for 

normally open and for normally closed 
contacts. One manual system is shutdown. 
Normally open is ON. Contact rating 
required is 15V DC, 2 mA DC. 

Battery No battery is required, or with battery, 

12V to 240V nominal, 100 to 10,000 
ampere-hours . 

Battery SOC Controls Ampere-hour accumulator accuracy +/- 5%, 

precision +/- 1%. 

Battery Voltage Limits Maximum absolute limit, maximum 

temperature compensated charging limit, 
maximum temperature compensated float 
limit, minimum absolute limit, all 
programmable 

Control Digital Outputs Optoisolator outputs, 6 total; pairs may 

be used as latching relay drivers. 

Control Analog Output 1 output +10V full scale, accuracy +/- 2% 

resolution 8 bits minimum. 

Test and Logger Output RS232 interface, 300 baud, full duplex 

Other rates programmable by EPROM change. 

Display LCD 4 1/2 digit display of battery SOC, 

any analog sensed input, calculated 
parameters, or error codes. 

Manual Input 16-key keypad to select displayed 

quantities or self-test 

Power Dissipation 5 watts or less for control elements only 

not including power modules or relays 


33 



FINAL REPORT 


Power to Other Elements 
System Loads 

Ambient Temperature 

Enclosure 


+12. 5V (+1V/-0.5V) at 0 to 50 mA 

Battery, resistive DC, permanent magnet 
or wound field DC motor, inverter /battery 

Operating -25 degrees C to +45 degrees C, 
shipping -45 degrees C to +85 degrees C 

NEMA-4 
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3.0 DESCRIPTION 


3.1 HARDWARE DESCRIPTION 

The prototype microprocessor PV system controller consists of a NEMA- 
enclosure containing the following major electronic assemblies: 

A . Power Supply 

B. Display and Control Interface 

C. Resistor Divider Board 

D. Power Modules (10) 

E. Processor 

A block diagram is shown in Figure 3.1-1. A photograph of the unit 
with internal cover open is shown in Figure 3.1-2. Schematic diagrams 
are attached in Appendix I. 

3.1.1 Power Supply 

The power supply consists of a wide input range DC to DC down 
converter and a multi-output flyback DC to DC converter. Total tare 
loss is 0.35 watts. The downconverter accepts 40V to 300V DC and 
produces 13.2 volts (referred to as a nominally +12V level) at up to 
0.6 amperes, with an efficiency of approximately 64 percent. This 
can charge a 12 volt battery and can directly drive the flyback stage 
whether a battery is present or not. The flyback converter produces 
regulated +5V DC at up to 0.7 amperes, plus unregulated outputs of 
nominally -5V and -12V DC. Its efficiency at the +5V output is 
approximately 84% The processor logic runs on the basic +5V output, 
the analog signal conditioning amplifiers and RS232 interface run on 
+/-12V, the analog multiplexers run on +5V, and the power modules run 
on +12V.' Total dissipation in the controller from a high voltage 
PV array, with NMOS EPROM's (CMOS units were not yet readily 
available) was 4.7 watts, distributed as follows: 

Processor and display 2.0W 
Power supply 2.3W 

Power modules 10 at 40mW = 0.4W 

The largest single power use is in the 9513 timer chip on the 
processor board, which uses about one watt at five volts. If a 
separate 12 volt supply or battery is used, thus avoiding down 
converter loss, total dissipation is only three watts. 

The power supply is fully short circuit protected, all outputs are 
over-voltage clamped, and the five volt output has an over-voltage 
crowbar reset by power off. 

3.1.2 Display and Control Interface 

The display board consists of a 4-1/2 digit LCD display, a 16 key 
membrane switch pad (calculator style), an audible alarm, and three 
LED's: RED, YELLOW, and GREEN. The keypad allows manual control 
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(under password security) of the system and calls up any one of over 
50 different quantities to be displayed. The display normally shows 
battery state of charge but can display the voltage, current, or 
power of any array string, load bus, battery, motor, or other 
monitored point, monitored temperatures, or time of day. The LED's 
summarize system status: The GREEN LED shows that the processor is 

running and servicing timer interrupts. The RED LED indicates that 
the battery is dangerously low and loads have been shed, and the 
YELLOW LED indicates that stored energy is in short supply and should 
be conserved. A listing of the keypad-accessible functions is given 
in the software section of this report. 

3.1.3 Resistor Divider Board 

The resistor divider board serves as an interface between the high 
voltages in the power system and the low voltage signals measured by 
the processor. High voltages above 40 V are attenuated by a ratio of 
100 to 1 before measurement while voltages from four volt to 40 volt 
full scale are attenuated by 10 to 1. 

3.1.4 Power Modules 

The power modules are 500 watt DC to DC converters used to couple the 
180 volt nominal solar array inputs to the 120 volt nominal battery 
and load bus. These are 20kHz switching type bucking converters, 
with typical efficiency of 98 % They include internal fast current 
limiting. Ten power modules are provided in the prototype. 

3.1.5 Processor 

The processor is a large board containing the following parts: 

1. Central Processor: CPU, timer, ROM, RAM 

2. Analog input section: differential current, 
multiplexer, single-ended voltage multiplexer, 
and 10 bit plus sign A/D converter 

3. Display and control interface: UART for RS232 
interface support; PIA for keypad, LED, LCD, 
and interrupt support; six optoisolators for 
load control 

4. Array control buffers: 10 digital outputs 
which can be used as pulse width modulated 
20kHz signals for the power modules for 
maximum power point tracking, or can be switch 
drive signals for discrete array control. 

The central processor is built around a 65C02 CPU which operates at 
1MHz with an eight bit data bus and a 16 bit address bus. This 
addresses 16k bytes of CMOS EPROM and up to 6k bytes of CMOS RAM. 
(This program requires only 2K of RAM.) Address and data bus buffers 
separate the central portion of the processor from the rest of the 
controller. A multiple timer, the AM9513, is used to generate the 
4MHz master crystal oscillator clock, 1MHz system clock, the time of 
day, the two pulse width modulated 20kHz outputs, the 16X baud rate 



clock for the RS232 port, and a Mmsec interrupt used in the program. 
All "glue" chips (assorted small gates) are of the 7^HC family for 
adequate speed at CMOS power levels. An address decoder for other 
major sections of the controller is also included in this section. 

The heart of the analog input section is the AD7571 analog to digital 
converter. This new device is a CMOS low cost unit, with 10 bits 
plus sign accuracy, and internal interface to an 8 bit microprocessor 
bus. It is used in its "RAM mode", externally clocked at 500kHz, to 
give an 88 microsecond conversion time, with an external TLW31 
precision reference. Simple external address gating and buffering 
included here also provide multiplexing onto the data bus of 
converter status, as well as two time of day alarm outputs and two 
external control switch status bits. 

The input to the converter comes from an analog multiplexer. This 
consists of a low offset buffer amplifier, channel selection latch, 
three 8-input single-ended CMOS multiplexers, and input filters. 

This services inputs for 16 voltage sampling channels, 16 currents, 
two thermistor inputs, a reference, a ground reference, and the 
current measurement differential multiplexer. Each voltage sense 
input, with +/-Mvolt range, includes a diode clamped anti-aliasing 
filter to avoid averaging errors when sampling at the 4msec interrupt 
rate, and which also filters out RFI and protects against high 
voltage spikes. Filtering throughout the multiplexer system is 
extensive, but settling time is limited mainly by the slew rate 
requirements of the buffer amplifiers. . Measured room temperature 
accuracy through the A/D converter is +/-0.2 percent. 

Current sense inputs, with +/-100mV range, utilize a differential 
muliplexer with gain of 40. This consists of an address decoder, an 
instrumentation-amplifier style buffer amplifier, four 4_input dual 
CMOS multiplexers, and a differential anti-aliasing filter on each of 
16 channels. This is also clamped for spike suppression and can 
tolerate +/-3volts common mode without significant accuracy 
degradation. This is needed to allow current shunts at reasonably 
remote locations in a large system, where wiring resistance drops can 
cause common mode offsets. Accuracy of 2 % can be trimmed to better 
than 1%, with a DC common mode rejection ratio of 60db minimum. 

Crosstalk in each stage of multiplexing is less than 0.1%, channel to 
channel, occuring with 10k signal sources at the voltage sense lines. 
This is limited by the "off" resistance of the low cost multiplexers 
used, and is adequate for this application but could be improved, 
since a worst case effective offset of just under +/- 2 % could result. 

Anti-aliasing filter design of the current sense inputs is based upon 
the possibility of 100 or 120Hz square waves on the battery current 
line, sampled at the 4msec rate and averaged 16 times, resulting in 
an accuracy of better than five percent. 

The display and control interface consists of a 65SC21 peripheral 
interface adapter (PIA) and an octal latch. The latch drives six 
4N32 optoisolator outputs via a hex buffer and series resistors. 



These resistors determine the output drive capability, and are 
presently set for 30 ma output drive. 

The PIA provides two programmable 8 bit input/output ports and two 
pairs of dual programmable interrupt latches. The input/output ports 
service the LCD display, the keyboard, and the signals for the LED's 
and audio alarm, and are inputs for the DART status flags. The 
interrupts provide for the Mmsec timer and the panic shutdown switch 
functions as well as UART service. 

The RS232 port is provided by an IM6^02 CMOS UART, which with a few 
discrete driver elements, makes a complete bi-directional 
asynchronoeus communications interface. At present, the parity, 
frame, and overflow error flags are ignored because a single system 
setting of baud rate and framing bits make these errors unlikely and 
error recovery in an unattended, stand alone system is impractical. 
This port allows data logging to an external printer, automated 
testing during manufacture, or computer interfacing in special 
applications. 

The array control functions consist of a set of latches, gates, and 
buffers allowing 12 digital outputs to be driven as independent relay 
drive signals for discrete array control, or as separately buffered 
pulse width modulated 20kHz signals for maximum power point tracking. 
A watchdog timer turns off the array control and load outputs if the 
processor fails to reset it within 80msec. An additional analog 
output, 0 to 10 V, is available for continuous analog control of 
variable loads such as variable speed motor drives. This is realized 
by low pass filtering of a second PWM signal. Alternatively, the 12 
array control outputs can be partitioned between the two PWM signals 
to provide max power tracking into two independent loads, although 
the present software doesn't yet fully support that mode of 
operation. 

3.2 SOFTWARE DESCRIPTION 

The software design was based on two decisions. First, the software 
is modular. This allows an orderly linking of software moudles using 
the principles of structured programming and allows modules to be 
modified without interfering with the rest of the program. Second, 
the modules were defined using "pseudocode", an explicit definition 
of each algorithm in plain English with a program format. This 
allowed clear communication between system designer, hardware 
designer, and software designer in advance of actual programming and 
eased the task of uniting assembly language code. 

The MAC unit is designed to operate without needing any human 
intervention. It performs the following functions automatically: 

1 . Battery Control 

2. Array Control 

3. Load or auxiliary display on the 

control panel 

Status display on the control panel 
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5. Self-test 

6. Data logging via RS232C port 

In addition, the MAC unit provides the following facilities for 
manual control: 

1. Manual battery charge initialization 

2. Manual array control 

3. Manual load or auxiliary charger control 

4. Control panel display of system 
operating parameters 

5. Manual test calibration mode and time of 
day 

6. Remote control and parameter measurement 
or automated testing via the RS232C port 

Each function is described below, with the automatic and manual 
functions described together for ease of understanding. A complete 
pseudocode listing by subprograms is given in Appendix II. The key 
parameters for a sample system personalization of the MAC are given 
in Figure 3.2-1. A detailed listing of the object code is available 
in the Task III Interim Report. 

3.2.1 Battery Control 

The state of charge describes the battery’s condition at an instant 
in time. The state of charge of the battery is defined to be a 
percentage equal to 100 times the number of ampere-hours the battery 
can deliver at 25 C at its specified rate, divided by the battery's 
rated ampere-hour capacity at 25 degrees centigrade. This is always 
less than 100 percent. 

The corrected state of charge is defined to be a percentage equal to 
100 times the number of ampere-hour capacity at 25 C. Note that this 
can be greater than 100 percent. 

The initial battery state of charge can be entered manually from 
either the keyboard or the RS232C terminal. This can be based on a 
hydrometer reading of battery acid density, or simply an estimate. 

If it is wrong, the system will eventually correct it without damage 
to the battery. Default value at power-up is 50 percent. 

The state of charge is increased by the number of ampere-hours 
flowing into the battery, and decreased by the number of ampere-hours 
flowing out of the battery. Rate of increase is modified by a 
tabulated coulombic charging efficiency which depends on state of 
charge as follows: 
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CONTROL PARAMETER LIST 

MAC-P10 S.N. 001 

MIN TYP MAX UNITS 

Array Voltage 156 180.0 350.0 volts 

Array String Current 2.0 2.5 amps 

Number of Strings 10.0 

Battery number of Cells 

series 54 54.0 54. 


Ampere-hour Capacity 400.0 A-Hr 

Float Voltage/Cell 2.4 volts 

Equal izationVolts/Cell 2.7 volts 

Min. Voltage/Cell — 1.9 volts 

Battery Current -60 +60 amps 

Charger Current Limit — 51.2 amps 

Load Current Limit 60. amps 

Temperature Measurements -5 25.0 60. deg.C 

Charger String Current Limit 6.5 amps 

Number of Load Busses 5.0 


FIGURE 3.2-1 



CHARGING EFFICIENCY 


soc 

0 TO .7 
.7 TO .8 
.8 TO .9 
.9 TO 1.0 


EFFICIENCY 

100 

.875 

.8125 

.6875 


If the battery voltage reaches 97% of its float voltage (corrected 
for temperature), it is automatically determined that the battery's 
state of charge is increased at one percent per second until that 
value is reached. 


Battery capacity at temperature is estimated by an increase of 0.2% 
per degree C above 25 C, and reduced by 0.75% per degree C below 25 
degrees centigrade. 

If the battery voltage drops below the minimum allowed, it is 
automatically determined that the battery's real state of charge is 
lower than the estimate, and the estimaed state of charge is reduced 
at 1% per second until the voltage rises above minimum due to load 
shedding or until 0 state of charge. 

For every ampere-hour of discharge by the battery, one equalization 
fraction ampere-hour of extra or equalization charging is 
automatically programmed when energy becomes available and 100% state 
of charge has been reached. This is needed to bring all cells up to 
full charge and to stir the acid by generating small amounts of gas. 
This prolongs total percentage to avoid excessive water useage. 

If the battery goes through many partial charge and discharge cycles 
before equalizing, the total equalization charge is limited to the 
equalization total percentage to avoid excessive water useage. 

During charging and equalization, the battery is allowed to rise to 
the equalization voltage. After equalization is completed, the 
battery voltage is limited to the float voltage, which is below the 
point of significant gassing and so uses up less water. This float 
level charge makes up for internal battery self-discharging. 

The float and equalization voltages are equal to a nominal voltage 
per cell minus 0.22% per degree C above nominal (temperature in 
degrees C minus 25 C), or equal to the absolute maximum battery 
voltage, whichever is lower. The battery minimum voltage has the 
same temperature compensation and an absolute minimum value. 

The result of these calculations, then, are the battery voltage 
maximum limit, the battery voltage minimum limit, the state of 
charge, the temperature corrected state of charge, and the 
equalization charge needed. 

Battery state of charge is channel DOO and battery corrected state of 
charge is channel DMO on the LCD display and the serial port. These 



are the most frequently read values, and so corrected state of charge 
Is put on the display by default at power up or after a data dump at 
half hour intervals. A diagram of the battery control algorithm is 
given in Figure 3.2. 1-1. 

3.2.2 Array Control 

If the battery is not fully charged and equalized, the voltage limit 
is the equalization voltage. If fully equalized, the voltage limit 
is the float voltage. Until reaching voltage limit, the solar array 
charges the battery as much as the available energy allows. 

There are two automatic modes of array control resident in the 
program. The first is discrete array control. This turns strings 
on, one per second as long as the battery voltage is less the of 
its maximum limit. It makes no change until the battery voltage 
reaches 97% of its maximum limit. Between 97% and 100% of its 
maximum limit, strings are turned off one per second. Above 100% of 
maximum limit, all strings are turned off. The battery voltage used 
for this algorithm is averaged over four samples to minimize noise 
problems . 

The second mode is maximum power tracking. The controller drives up 
to 10 power modules with a 20kHz pulse width modulated drive signal, 
13 volts = high = OFF, 0 volts = ON. The pulse width is set in 1 /^ 
microseconds increments. It is initialized to 0 and changed in small 
(1/ii microseconds) or large (2 microseconds) steps every 100 
milliseconds. At each step, the total delivered power is calcualted 
and compared with the power delivered at the previous duty cycle. If 
the power changed by less than 1.5%, and if no limiting conditions 
were encountered, small steps are used, otherwise big steps are used 
to speed up the process. 

If the power level was found to be constant or increasing, the next 
step is taken in the same direction as the last. If -the power was 
found to be decreasing, the direction of step in duty cycle is 
reversed. Therefore, the duty cycle is adjusted to the maximum power 
operating point, and hunts there +/- one or two small steps, 
representing an operating point within +/- 1% of maximum power. 

If the charger current limit or battery maximum voltage limit is 
reached or if switch S2 is open, the duty cycle is always decreased 
one step. This converts the controller into a constant voltage or 
constant current power supply, normally used for finishing charge of 
batteries or for motor starting without batteries. 

Also, if the inhibit switch SI is closed, the duty cycle is set to 0, 
turning off the solar array. Switch S2, normally closed, is usually 
used as a motor thermostat, while SI is often used as a water tank 
float switch level control. A manual switch in parallel with SI, 
normally open, provides a manual array shut-off function. 
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BATTERY STATE OF CHARGE CONTROL ALGORITHM 



soc 

(State-Of-Charge) 


Equalization 

Count 


Charging 

Control 


Corrected 

SOC 


Load Control & 
Warning Lights 


FIGURE 3. 2. 1-1 


45 









The sequence of events for max power tracking is as follows: 

1. Pulse width is set on the previous program pass. 

2. 12 milliseconds settling time elapses. 

3. 16 values of each of the 10 charger string currents, the battery 
voltage, & the battery current are stored in an array. The table is 
filled by taking a sample of all values once every 4 milli-seconds, 
which generates a column of "instantaneous" data. After 64 milli- 
seconds, all the rows of data are full and average values are 
calculated . 

4. User output power is calculated. In order to avoid start-up 
problems with low impedance (motor) loads, the actual parameter to be 
maximized is (total charger amps) X (battery volts + 100). 

5. Old and new power are compared. If power is increased, the 
direction of pulse width step is left the same. If power is 
decreased, the direction is reversed. 

6. The size of the pulse width change is calculated based on the size 
of the power level change. This is a novel feature which allows fast 
acquisition and accurate tracking of the max power points. 

7. The pulse width is changed, and the process repeats at 100 
millisecond intervals. This algorithm is diagrammed in 
Figure 3. 2. 2-1. 

3.2.3 Load or Auxiliary Charger Control 

The battery is assumed to be loaded by up to five separate load 
busses, with separate voltage sensing, current shunts in the negative 
load, and relay control responsive to the optoisolator output 1-5 of 
the controller. (Optoisolator 0N=load ON.) These may in fact be 
auxiliary energy sources as well as loads. 

Each load bus is automatically monitored for excessive current. If 
current exceeds 120 percent of the nominal value (50mV on the shunt), 
the load is turned OFF, the audio and red LED alarms turned ON, and 
manual reset is required via keyboard or serial port. Under normal 
conditions, each load bus has two corrected state of charge 
thresholds; one below which the load is turned OFF (shed) and one 
above which the load is turned ON (restored). By reversing the 
function of the optoisolator, an auxiliary generator can be properly 
controlled the same way. This provides fail-safe operation, since 
the optoisolator going off turns loads OFF and generators ON. Note: 
for either case, shed level is less than restore state of charge by 
an amount which avoids cyclic behavior. A list of sample control 
levels is given in Figure 3. 2. 3-1. 

Each load or charger bus can also be manually controlled from the 
keypad or the serial port. To be turned ON, (Load ON, Charger OFF, 
Optoisolator ON), an optoisolator must be ON according to all 
automatic control algorithms and the manual control function. 
Otherwise, it is in the load OFF/charger ON condition. 

It is often desirable to use more energy if it’s going to be a sunny 
day. This may be to avoid short cycles of load useage or simply to 
increase energy useage efficiency. Therefore, between SAM and 


46 



MAXIMUM POWER CONTROL ALGORITHM 



FIGURE 3. 2. 2-1 










CORRECTED STATE OF CHARGE THRESHOLDS 

(Percent) 


LOAD 

SHED 

RESTORE 

1 

20 

40 

2 

30 

50 

3 

40 

60 

4 

50 

70 

5 

50 

90 

MORNING DELTA SOC 


1 0 

SOC TOP 

— 

80 

EQUALIZATION FRACTION 

— 

20 

EQUALIZATION TOTAL 

— 

40 


ARRAY CONTROL MODE: Maximum Power Tracking 

SWITCH CONTROL: 

Charger ON if SI open = 0 and S2 closed = 1. 
Product storage path = Load Bus 6. 


•Auxiliary Equi pment 

Load Bus Shunts 50A = 50mV 

Thermistors 25C = 10k ohms 


FIGURE 3. 2. 3-1 



12Noon, if the sunlight level is high enough to provide at least 10% 
of the maximum charger current limit to the battery, all the battery 
corrected SOC levels for load shed and restoration are decreased by a 
constant preset SOC, called DELTA SOC. This allows loads to turn ON 
earlier on a sunny morning than would otherwise be the case. 

The MAC can perform a control strategy to allocate available energy 
into two different forms of storage. One of these is electrical 
energy stored in a battery. The other is a form of "product 
storage." This might be water stored in a tank, or thermal storage of 
cold in a refrigerator, freezer or ice stored in an icemaker. 

To use this capability, it is necessary to be able to measure the 
amount of product stored or at least to indicate one of three product 
storage levels: 

1. There is less than the critical minimum amount of product (water 
level or cold temperature in the freezer) and it has a high priority: 
PROD < PROD 1 

2. There is an adequate amount of product, but more can be stored if 
energy is available. PROD 1 < PROD < PROD 2. 

3. The product storage level is full (tank is full of water or 
refrigerator is at minimum temperature): PROD > PROD 2. 

This product is assumed to be produced or pumped using energy from 
the same battery which is used to supply other electrical loads. To 
avoid over-discharge of the battery and to be sure the other loads 
get their share of energy, various state of charge (SOC) of the 
battery are defined: 

1. Battery minimum charge: below this, the battery is below its 

minimum allowable state of charge and all load are off, above this 
non-product electrical loads are allowed: S0C1 

2. The battery can be used to produce product but not other 

electrical loads above this point: S0C2 

3. The battery can power both electrical loads and non-critical 
product levels above this point, but only non-product electrical 
loads below this point: S0C3 The battery will power all loads 
above this point: S0C4 

This combination of trip points creates a set of four states of the 
controller, defined by the amount of product stored and the battery 
state of charge. This state diagram is shown in Figure 3.2. 3-2. By 
setting various values for the boundary parameters, various 
priorities can be placed on the use of energy. To avoid limit cycles 
during operation, a buffer or hysteresis of specified amount is added 
to each boundary value when crossed in the increasing direction. The 
parameters for the product storage algorithm are given in the tables 
in Figure 3.2. 3-3 



Increasing Amount of Product 
Stored 


PRODUCT STORAGE ALGORITHM 


Increasing Battery State of Charge 

— — _^(i^ 


V 


STATE 1 

Electrical Loads 
OFF 

Product Load OFF 



STATE 3 

Electrical Loads OFF 
Product Load ON 




STATE 2 

Electrical Loads ON 
Product Load OFF 


] STATE 4 
Electrical Loads ON 
Product Load ON 


FIGURE 3. 2. 3-2 




PRODUCT STORAGE ALGORITHM THRESHOLDS 

(Percent) 


PROD = (25 

- T2) 

*3.3 T2 

in degree C 


DEFINITION 

SYMBOL 

VALUE 

HYSTERESIS 

VALUE 

El ect 1 oads above 

SOCl 

20 

BUF SOCl 

10 

High Priority 

PROD only above 

S0C2 

50 

BUF S0C2 

20 

Low Priority PROD 

S0C3 

70 

BUF S0C3 

1 0 

above 

Low Priority PROD 

S0C4 

70 

BUF S0C4 

10 

& Elect above 

High Priority 

PRODl 

50 

BUF PRODl 

10 

PROD only til 

No PROD above 

PR0D2 

80 

BUF PR0D2 

1 0 


FIGURE 3. 2. 3-3 
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3.2.i» Control Panel Functions 

The control panel has a keypad for manual inputs, a ^-1/2 digit LCD 
display for selected quantities, a set of red, yellow, and green 
LED's for quick status summary, and an audio alarm. There is also an 
emergency switch located at the bottom of the unit which, when turned 
OFF, will turn OFF all array strings and loads. When turned ON, it 
will initialize the controller. 

The audio alarm will sound if any "circuit breaker" function 
(overcurrent on a load bus) is activated, or if an array fault is 
detected . 

The red LED will light if any circuit breaker function is tripped or 
if bus N0.1 has been shed due to low state of charge (extreme low 
battery). The LCD "Low Battery" warning will also turn ON. 

The yellow LED will light is load bus NO. 5 has been shed due to low 
state of charge, but load bus NO.l has not. This is intended to 
signal that energy is in short supply, but not an emergency. (Lower 
number loads usually have higher priority.) 

The green LED is lit as long as the program is running. If a 
watchdog timer is not reset by the program, this LED goes out and the 
array is turned OFF. 

The LCD display can be thought of as a multimeter which will display 
one of a menu of system parameters. The default condition is state 
of charge, and after a data dump each half hour, it returns to this 
parameter. It can also display any array string voltage, any charger 
output string current, (not the array current, but the converted 
output from that string at the battery voltage level), the delivered 
string power to the battery, the battery voltage current or power, 
any of five load bus voltages or currents or powers, the battery 
temperature, one other temperature (used here for freezer product 
measurement), the pulse width, the equalization charge needed, the 
system zero voltage and 4.00 volt reference level, the temperature 
corrected state of charge, the time of day, and the software version 
number. See the attached signal channel list. Enter the desired 
channel code (a letter, two numbers, and a (/) for display. The 
sign has the effect of an "enter" command. The * sign cancels an 
incomplete entry. A list of public acess functions is given in 
Figure 3. 2.4-1. in addition, after entry of a password on the 
keyboard, an additional set of protected functions becomes available, 
listed in Figure 3.2. 4-2. 

3.2.5 Self-testing 

The keypad can also be used to change control functions. To do this, 
the correct password must be entered: 4 digits followed by a #. 
Passvtord accessible functions are summarized on the attached command 
list. These include setting a new load and restore thresholds for 
each load bus, setting initial state of charge and setting the manual 
control for each load bus optoisolator to "ON = 1" or "OFF = 0", 
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PUBLIC FUNCTIONS 


SEQUENCE 

FUNCTION 

* 

Clear Function 

aaaa# 

Activate password-accessible functions 
if user password matches (see below) 

Ann# 

Read channel nn voltage (mult) 

Bnn# 

Read channel nn current (muTt) 

Cnn# 

Read channel nn power (mult) 

Dnn# 

Read misc data channels (mult) 

AA# 

Display software version number 

BB# 

Read time, hours and minutes (mult) 

CC# 

Initiate "dump" of machine state to 
serial port 

DD# 

not used 


FIGURE 3. 2. 4-1 



PASSWORD ACCESSIBLE FUNCTIONS 


SEQUENCE 


FUNCTION 

Annimm# 


Set load shed threshold for load 
n at mmm 

Bnniinm# 


Set load restore threshold for load 
n at mmm 

Cinmm# 


Set the initial percentage SOC at 
mmm% 

Dnnm# 


Set device nn to condition m, where m 
must be either a "1" (ON) or a "0" (OFF) 


device 0 
device 1-6 
device 7-11 
device 12-17 
device 18-23 
device 24-25 

Audible alarm 

User load requests 1 through 6 
Overload trip resets for loads 1 through 5 
PWM buffer #1 controls 1 through 6 
PWM buffer #2 controls 1 through 6 
Yellow and Red LEDs 

AA# 


Initiate lamp and annunciator test 
(accessable only in test/cal mode) 

BB# 


Toggle from run to test/cal mode 
(system comes up in the run mode) 

CChhmm# 


Set time, hours and minutes 

DD# 


Cancel password authorization 


FIGURE 3. 2. 4-2 
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Also, the unit can be placed in a test/cal mode where data is 
refreshed but the states of charge, max power tracking and load 
controls do not automatically change. This allows them to be 
manually set and measurements taken. For example, a fixed pulse 
width can be set from the serial port, or a lamp test can be 
performed. Note that this mode is not well protected and the system 
should not be left in this condition unattended. 

A lamp and audio alarm test can be performed in this mode. This 
lights all LEDs, sounds the alarm and put test digits in the display. 
The keypad in password-access mode can also be used to set the time 
in hours and minutes on a 2M-hour clock and can cancel the password- 
access mode. 

The display performs one more automatic test. If one of the charger 
power module output currents is less than a constant (1 amp) below 
the average of all such currents, the "Continuity" segments of the 
LCD is turned ON. This means that one string of the array or one 
power module of the charger is either shadowed or broken. 

Examination of array voltages and currents will show the cause. 

Besides these external tests, the unit performs an automatic test of 
its RAM and ROM access whenever it is started up. When running, any 
error causing the program not to execute properly will result in a 
watchdog timer fault turning off all loads and the solar array and 
causing the green LED to go out. 

3.2.6 Serial Port Functions 

The manual test/cal mode was partially described in the previous 
section. However, with an RS232C terminal, much more extensive 
manual testing is possible. A standard debug monitor is implemented 
which can examine memory locations, insert bytes into memory, begin 
execution at a given memory location, insert or remove breakpoints, 
and download a program into memory. 

In addition, any of the keyboard command functions can be performed 
from the serial port. A list of these commands, plus the debug 
monitor commands is in the serial port section of the command list. 
Note that no password is requried via the serial port. The debug and 
monitor functions are listed in Figure 3. 2. 6-1, and the maintenance 
functions are listed in Figure 3. 2. 6-2. 

A data dump of all system voltages, currents, temperatures, switch 
positions and states of charge is sent to the serial port every half 
hour or whenever requested. A printer there will provide data 
logging. The format of this data is given in Figure 3. 2. 6-3. 

This powerful access allows many possible uses. The processor can be 
automatically tested during manufacture. A printer attached at the 
site can serve as a data logger. A telephone modem or other 
communication interface would allow automatic remote data logging or 
even, remote system control. A tape recorder will allow post- 
processing of recorded data. 



DEBUG MONITOR FUNCTIONS 


SEQUENCE 

"H, backspace, del 

"U 

TZ 

M a ddr 


G addr 
B addr 
X 

1 addr 

F start addr end addr 


FUNCTION 

Deletes last character entered. Echoes 
backspace, space, backspace to allow 
overwriting the last character entered when 
a CRT terminal is used 

Causes CPU to ignore present command line 
Return to command mode 

Opens a memory location at the specified 
address (requires 4 hexadecimal digits). 
Successive "" (space) characters increment 
through memory, while characters decrement 
through memory. At any time the contents of a 
location may be altered by entering the new 
data followed by a carriage return. 

Begins execution at the specified address. If 
no address is specified, execution begins at 
the present PC location 

Places a breakpoint at the specified address. 
This trace mode will only work on code located 
i n RAM 

Removes existing breakpoint 

This permits a program to be downloaded from a 
host machine to memory starting at the specified 
address 

datum Fills the specified memory range with specified 
byte of data 



MAINTENANCE and LOGGING FUNCTIONS 


SEQUENCE 

W pwm timer no. duty cycle 


0 digit no. value 


Enn 


FUNCTION 

Set the Power Module duty cycle to 
specified value. If duty cycle 
max pwm, the default duty cycle is 
set to max pwm. 

Display the value in the specified 
digit on the LCD display. 

Read channel nn voltage 


Inn Read channel nn current 

Pnn Read channel nn power 

Dnn Read misc data channels 

Qnn Query channel nn for "raw" A/D data 


FIGURE 3. 2. 6-2 



DATA FORMAT 


TIME; hh;mm 


EOO 

= 

XXX . X 

VOLTS 

100 

= 

XXX . X 

AMPS 

EOl 

= 

XXX . X 

VOLTS 

101 

= 

XX . XX 

AMPS 

E02 

= 

XXX . X 

VOLTS 

102 

= 

XX . XX 

AMPS 

E03 

= 

XXX . X 

VOLTS 

103 

= 

XX . XX 

AMPS 

E04 

= 

XXX . X 

VOLTS 

104 

= 

XX . XX 

AMPS 

EOS 

= 

XXX . X 

VOLTS 

105 

= 

XX . XX 

AMPS 

E06 

= 

XXX . X 

VOLTS 

106 

= 

XX . XX 

AMPS 

E07 

= 

XXX . X 

VOLTS 

107 

= 

XX . XX 

AMPS 

EOS 

= 

XXX . X 

VOLTS 

108 

= 

XX . XX 

AMPS 

E09 

= 

XXX . X 

VOLTS 

109 

= 

XX . XX 

AMPS 

El 0 

= 

XXX . X 

VOLTS 

11 0 

= 

XX . XX 

AMPS 

E31 

= 

XXX . X 

VOLTS 

131 

= 

X . XXX 

AMPS 

E32 

= 

XXX . X 

VOLTS 

132 

= 

X . XXX 

AMPS 

E33 

= 

XXX . X 

VOLTS 

133 

= 

X . XXX 

AMPS 

E34 

= 

XXX . X 

VOLTS 

134 

= 

X . XXX 

AMPS 

E35 

= 

XXX . X 

VOLTS 

135 

= 

X . XXX 

AMPS 

036 

= 

XXX . X 

OEG C 

D37 

= 

XXX . X 

DEG C 

E38 

= 

X . XXX 

VOLTS 

139 

= 

X . XXX 

VOLTS 

DOO 

= 

xxx% 


D4 0 

= 

xxx% 


041 

= 

xxx% 


D42 

= 

xxx% 


Sl-1 


S2- 

0 

LI -1 


L2- 

0 L3 





L5-1 


L6- 

0 

Al-1 


A2- 

1 A3-1 

Bl-1 


B2- 

1 B3 

A4-1 


A5- 

1 A6-1 

B5-1 


B6- 

1 

TOT 

CHGR I 

= XXX. X AMPS 






NOTE : 


1=0N 


0 = 0FF 
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The use of a small RS232C terminal by a repair technician allows 
fault isolation and diagnosis beyond the capabilities of the keypad 
and display, since small special test routines can be run. Software 
modification is greatly eased as well. 

3.3 SYSTEM CONFIGURATION 

To utilize these rather sophisticated control algorithms is very 
simple. Typical system configurations for a pumping unit without 
batteries is shown in Figure 3.3-1. Note that this is just the 
minimal amount of wiring required for such a system. Similarly, the 
system configuration for a battery-type system is shown in Figure 
3.3-2. The processor contains all the control complexity, making the 
system designer’s job easier. The functions performed by the 
processor are summarized in Figure 3.3-3. To implement these, only 
the proper system parameters need be inserted in the processor EPROM 
memory. In this way, the user or installer needs the minimum 
knowledge of system theory to be able to use the controller. 

M.O PRODUCTION COST ANALYSIS 

4.1 MAMUFACTURUNG COST 

The results of costing the system can be summarized by several 
points. Each extra analog channel to be measured is expensive 
because the filtering and multiplexing associated with each channel 
quickly adds 3 to 5 dollars per channel to the overall cost. The 
analog input section of the processor represents almost half the PC 
board area and about 1/3 of the cost. 

The largest single area of cost is the CPU itself, dominated by 
memory cost, mainly from EPROM's. These are rapidly becoming less 
expensive, and in a few years, a single larger EPROM and a single 2K 
RAM will probably enable the entire system to be built at lower cost 
and less power. 

The power supply, rather expensive at present, can be simplified for 
most applications in the future, since the total controller power can 
be reduced. Also, a separate +12V output from the flyback stage is 
not needed, and -5V power can be derived from a Zener diode operated 
from the -12V supply. This cuts its cost by perhaps 1/3. 

Availibility of a CMOS timer chip with the capabilities of the 9513 
would help a great deal in reducing power and perhaps costs. In 
general, the increasing industrial use of CMOS is expected to bring 
costs of many components down. The power handling section of the 
controller, consisting of DC to DC power conversion modules, can be 
replaced in low cost battery systems with electromechanical or 
mercury displacement relays or solid state DC switches and the 
discrete array control algorithm. It will also cost half as much. 
This will be the direction of choice for battery charging as solar 
arrays become cheaper. Also, eliminating these PWM outputs would 
allow replacement of the 9513 timer chip with a lower power, less 
expensive timer. However, for many motor drive applications, the 
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TYPICAL PUMPING SYSTEM WIRING 



Figure 3.'3-1 



















MICROPROCESSOR CONTROL FUNCTIONS 

1. BATTERY CONTROL 

A. State-Of-Charge Estimation and Correction 

B. Equalization Charging 

C. SOC Initialization and Enunciation 

D. Warning Lights 

2. PHOTOVOLTAIC ARRAY CONTROL 

A. Discrete Subarray Switching 

B. Maximum Power Point Tracking 

3. LOAD MANAGEMENT 

A. Priority Load Sector Management 

B. Backup Generator Control 


c. 

Manual Load Control 


D. 

Product Storage Energy 

A1 1 ocati on 

SYSTEM STATUS 


A. 

DC Voltages, Currents, 

Power Levels 

B. 

Temperatures 


c. 

Battery SOC, Corrected 

SOC 

D. 

Variable: Control Level 


E. 

Relay Status 



5, AUTOMATIC TESTING 

A. Processor Self-Test 

B. Load Circuit Breaker Functions 

C. Array Continuity Test 

D. Battery Level 

E. Audible and Visual Alarms 

6. DATA LOGGING AND COMMUNICATIONS 

A. System Status Log Each 30 Minutes 

B. Remote Telemetry 

C. Remote Control 

D. RS 232 Port 
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MFC arrangement is superior. 

The power module is the only proprietary element in the controller. 

It is a standard product of TriSolarCorp. 

A material cost breakdown of the controller subsystems is given below 
for present day quantities of 10: 


DESCRIPTION 

COST 

Current Measurement Mux 


Analog Mux 

56.69 

A/D Converter 

27.83 

PWM Buffers and Array Control 

2ii.75 

CPU 

108.29 

Power Supply 

83.1^ 

Display and Interface Board 

ii9.82 

Resistor and Interface Board 

5.00 

Processor Subtotal 

M99.56 


The resulting material costs are then calculated below for the 1KW, 
5KW, and 15 KW systems: 



1KW 

5KW 

15KW 


No MPC 

MPC 

MPC 

PROCESSOR 

iJ59.56 

i^99.56 

559.56 

POWER SECTIONS 

100.00 

1121.20 

3363.60 

ENCLOSURE 

165.00 

165.00 

495.00 

TERMINALS 

20.00 

27.00 

81.00 

HEAT SINKS 

0.00 

138.00 

416.64 

SHUNTS AND HARDWARE 36.25 

36.25 

68.75 

TOTAL MATERIAL 

780.81 

1987.89 

4984.55 


Material prices are assumed to be reduced by 25% for each 10X 
increase in quantity. 
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Labor costs are very volume dependent. Use of automatic test 
equipment, wave soldering or automatic component insertion are 
examples of labor-saving techniques which can be applied at various 
levels of production. 


Total labor costs 
estimated below; 

for various models 

and production 

levels are 

MODEL 

QUANTTTY/YEAP 

1KW 

5KW 

15KW 

10 

476 

768 

1400 

100 

280 

452 

819 

1,000 

168 

266 

482 

10,000 

100 

160 

282 

100,000 

60 

100 

170 


Labor is broken down into wage levels. For example, for each model 
given, the following hours are needed for quantities of 1,000 per 
year: 



$/hr 

1KW 

5KW 

15KW 

Class 1 

22.60 

1 

2 

3 

Class 2 

13.50 

3 

6 

10 

Class 3 

7.00 

15 

20 

40 


These labor estimates are conservative; the actual number for such 
volume of production will probably be lower. However, these seem to 
be reasonable based on our limited experience with the protopype 
unit. 

Resulting total direct costs per 5KW unit, including labor and 100% 
overhead plus material are therefore just under $2^*00 in quantities 
of 100 per year. The 1KW unit in the same quantities costs under 
$1200. These are quite reasonable costs compared to alternative 
custom designed controllers. The real payoff, of course, occurs at 
higher volumes. 

The total direct cost of the three models, including material, labor, 
and 100% overhead is summarized in the following table. 


QUANTITY/YR 

1KW 

5KW 

15KW 

10 

1732 

3524 

7785 

• 100 

1145 

2395 

5377 

1000 

775 

1650 

3768 

10000 

529 

1158 

2667 

100000 

367 

829 

1916 


64 
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4.2 MODELLING OF INDUSTRIAL PRODUCER 

In order to capture all the costs associated with producing this 
controller in a rapidly growing commercial environment, a model was 
constructed of a company which would make only this unit in 
quantities of 10; 100; 1,000; 10,000; and 100,000 per year in 
successive years. Industry standard or typical ratios were used for 
the computer electronics industry in Massachusetts, based on advise 
of consultants experienced in this area. Overhead, inventory, 
equipment, G&A, and other costs were captured in this model. The 
result gives a picture of cash flow and return on investment as well 
as profitibility. 

The costs of the controller are used for this hypothetical company 
producing various quantities of 1, 5, and 15kW controllers, the 
resulting income statement, balance sheet, and cash flow projections 
apply. Note that for quantities under 1000/year, a dedicated company 
for just this purpose is not feasible, and losses result. For very 
small numbers of units (10) per year, costs go up and prices reflect 
the custom nature of the product. However, for larger volumes, 
prices are quite reasonable and return on investment becomes very 
attractive. Figure 4.2-1 (3 pages) shows these figures. 

The first three lines show the unit sale price of each of the 
three controllers; 1=1kW, 2=5kW, 3=15kW. The next three lines, 
labelled unit sales, show projected sales numbers for each type. The 
following three lines, labelled number of people, give the number of 
employees needed at each of three salary levels, defined on three 
wage level lines immediately below. The following three material 
cost lines give cost of material per unit for each of the three types 
of controller. The last line, micro dollars per unit, indicates the 
equivalent material cost of the PV panel needed to power the 
controller. The interest rate for each year is indicated below. 

The next section is an income statement for the model company. 
Sales and cost of sales are computed from the above values. G and A 
and overhead are calculated using typical electronics industry 
ratios. The resulting net after tax shos profitability after sales 
pass a few million annually, and look good at large volumes as a 
fraction of sales. 

The next lines are a balance sheet showing assets and 
liabilities. Typical industry ratios for inventory, receivables, and 
payables are used. The line marked "plug” represents extra 
capitalization needed, loan or equity, to fund this rate of rapid 
expansion. 

The last page shows cash flow, and points up the negative cash 
flow from operations due to the rapid growth rate. The use of 
investment cash is divided mainly between inventory increase and 
purchase of fixed assets. The return on investment can be seen by 
company increase in long term debt with net after tax profits. 
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5.0 TESTING 

The MAC 5 kilowatt prototype was tested in several stages. Its basic 
hardware was tested at TriSolarCorp. Its software was tested at the 
Mellon Institute. Then the integrated hardware and software was 
extensively tested at TriSolarCorp, resulting in further development 
of some algorithms. Finally, testing in four system configurations 
was planned for NASA's STF system test and completed at TriSolarCorp 
The test facility included a 2.4kW power supply, a ^80W solar PV 
array, a lOOA-hr 108V lead acid battery bank, a 5kW resistive 
adjustable load, a 1HP DC motor driving a jack pump with adjustable 
hydraulic load, and assorted control and sense elements. A schematic 
of the test set-up is included in Appendix A. The first set of tests 
used power supplies to calibrate the various inputs and to simulate 
battery charge and discharge cycles. These tests showed that all 
systems worked properly, with accuracy within the +/- 2 % 
specification. It became clear that accuracy better than could be 
attained by replacing the discreet .resistors on the divider board 
with precision resistor networks, a change involving very little 
extra cost. During this test phase, a subtle program bug in the 
battery state of charge subroutine was found and fixed. Power module 
efficiency was verified to be 97 to 98^ at these voltages. The 
second test phase used the controller with the battery, solar array, 
and resistive loads. 

The battery charge control algorithm works as described. Its 
estimate of the available capacity is limited mainly by the accuracy 
of the battery's rated capadity at a given discharge rate. This 
figure is reproduceable only to about 10? accuracy, and is usually 
based on 5 years or fixed cycle life end of life capacity. The 
initial capacity increases for a few cycles then slowly decreases 
with life. Therefore, the displayed battery capacity and the load 
management algorithm tend to be conservative by 10 to 20? over the 
first years of battery life. Long term low current operation is 
limited by internal battery self-discharge, typically 1? to 2? per 
week, and current effect errors of 0,1? of maximum, which is often a 
similar percentage per week. This is corrected whenever the battery 
is fully charged, so that batteries cycled daily or weekly are not 
affected. 

The array control modes, both max power tracking and discrete 
switching, work very well and provide a nice tapered current 
finishing charge for a battery with very low water loss. 

Load management in response to battery state of charge is very good. 
It is free of the chattering and instability characteristics of many 
voltage-related load management schemes. 

Instrumentation of the system using the keypad and LCD display is 
very effective. A permanently posted list of command codes on the 
unit near the keypad was found to be useful. 

Data logging via the RS232C terminal to an inexpensive printer will 
be very helpful in village systems. Of less use in smaller 
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applications, it is quite helpful for maintenance or fault diagnosis 
using a small hand-held battery powered RS232 terminal. The 
possibilities inherent in a phone coupler or other communications 
port for remote system control have not been explored, but they are 
potentially very interesting. The self-test functions of the 
controller are an effective means of allowing unskilled personnel to 
monitor a complex PV system. 

The third set of tests used the MAC to operate a jack pump without 
batteries. Combinations of insolation (simulated by moving the 
array), total dynamic head, and load-levelling flywheel size were 
compared. The controller successfully performed its maximum power 
tracking task here as with a battery load, unless the variation in 
load current was faster than a fraction of a second over a range of 
over 50% change in load current. The MAC was also compared to 
previous models of max power trackers. The max power tracking with 
two steps sizes is a real advance in the state of the art, as it 
provides a combination of more accurate tracking of a static max 
power point load and faster acquisition time for a varying load or 
insolation. A chart comparing these performance figures is given 
here. Note that this control method is proprietary and a patent has 
been applied for. 


COMPARISON OF MPC FUNCTIONS 


PREVIOUS STATE OF THE ART MAC 

EQUIPMENT 

Acquisition Time 3 sec 1 sec 

Max Dither, stable 3% 1% 

Product 9 1 


This means, for example, a volumetric pump or other slowly 
cycling loads can be dynamically matched to the solar array with 
reduced need for expensive or costly load levelling mechanisms such 
as large flywheels, batteries, etc. This opens up additional 
applications for the controller. Flywheels previously sized for 5 
strokes of energy for the pump at full speed can now be made to store 
only 1 stroke of the pump at full speed, saving considerable cost and 
energy. 

In fact, operating the jack pump without any flywheel resulted in no 
loss of output. However, system parameters were poorly controlled 
under this condition, and the array and motor voltage varied for 
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short periods of time over a wide range. 

In very low light levels (dawn or dusk) the operation of the 
controller was irregular as it alternately started and stopped 
internal operation. This is common with many solar devices, and it 
caused no damage or loss of output, but it is not well controlled. 

A change of control parameters is suggested to improve this: reducing 
the step size at small pulse widths, and reducing the minimum pulse 
width. 

The last set of tests used the battery, array, power supply, 
resistive load, and simulated product storage to test the product 
storage dual-use algorithm. This operated as it should, but showed 
sensitivity to the programmed threshold values and was difficult to 
diagnose. It may be a bit complicated for remote village use, 
although it can be used to allocate energy between several uses. Its 
sophistication makes it difficult for a user to verify that it is 
operating properly, and this may make it less popular than other 
approaches based solely on battery status. 

The overall result of the testing was that the MAC unit works and 
works very well. In comparison with other existing controllers, the 
microprocessor automatic controller worked as well as, or better 
than, any existing PV system control equipment, and can be adapted to 
a wide variety of systems simply by plugging in an EPROM. This makes 
it a very attractive controller for PV systems where large size (over 
2kW), remote location or special control requirements justify this 
type of unit. 

6.0 CONCLUSIONS 

The battery charge control algorithms in the MAC provide stable, 
predictable operation of the system and will do a good job of 
extending battery life, minimizing maintenance, and accurately 
estimating state of charge. The load management controls are 
flexible and provide good prioritized control without any problems of 
chatter or noise sensitivity. 

The array controls work well in either the maxpower tracking, pulse 
width modulated mode or in the discrete array switching mode with 
sequential operation. In the maxpower tracking mode, the dual step 
size algorithm is a real advance in the state of the art and allows 
tracking of varying loads which is both faster and more accurate than 
previous controllers. 

The metering and data logging functions provide a good picture of 
overall system status. The self-test functions auch as array string 
continuity testing will be very useful in substituting for skilled 
operators at remote sites and allowing scheduled system maintenance. 

The potential for remote system control and monitoring is 
considerable. The full use of the RS232 port capabilities of this 
controller have not yet been fully explored. Remote system 
monitoring or control, various types of data logging, or other 
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maintenance or communications functions are possible. This may make 
the microprocessor controller attractive in other kinds of systems, 
such as utility interactive PV systems or non-PV applications. 

The success of this development will allow rapid production of the 
unit for field application. 
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The following drawings show the microprocessor automatic PV 
system controller at the system level, PIO (5 kilowatt) box 
level, and the board level. 


The drawings attached Include: 


C02-00414-01 

C02-00416-00 

C02-00418-00 


Microprocessor Power Supply 
Microprocessor Controller Test Configuration 
Microprocessor Display and Control Logic 


D02-00413-01 
D02-004 13^02 
D02-00420-00 Sheet 1 
D02-00420-00 Sheet 2 
D02-00420-00 Sheet 3 
D02-00420-00 Sheet 4 
D02-00420-00 Sheet 5 


Microprocessor PIO Wiring Diagram - Busses 
Microprocessor PIO Wiring Diagram - Single Wires 
Microprocessor Schematic - Central Processor 
Microprocessor Schematic - PWM Buffers and Array Controls 
Microprocessor Schematic - A/D and Interface Logic 
Microprocessor Schematic - Analog Multiplexer 
Microprocessor Schematic - Current Measurement Mux 
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1_. The Use of Pseudocode 

The majority of the information regarding the software package 
developed by the Mellon Institute Computer Engineering Center (MI/CEC) 
for the captioned Tri Solar project is contained in. the pseudocode 
listings which accompany this summary. The pseudocode is a fictitious 
high level language used to document and describe the assembly code 
used in each of the routines. The use of flowcharts has, in the past, 
been cumbersome to keep updated as corrections and modifications are 
incorporated into a piece of code. A pseudocode listing, on the other 
hand, is easily understood and can be incorporated as part of the 
comments in the assembly language code. The size of the source code 
file in this particular project, however, required that the pseudocode 
be kept in a separate file. 

The syntax of the pseudocode generally follows the PL/M-86 
language which was selected because it was more "eng I i sh- I i ke" than 
many of the other programming languages. It should be pointed out 
that occasionally constructs not supported by PL/M-86 were required. 
When this happened, the syntax rules were "bent" somewhat to allow 
english phrases or carefully selected syntax from other languages to 
fill the void. The meaning is still clear to anyone with familiarity 
with programming in general. 

By first writing the routines in the pseudocode and then 
translating the resulting pseudocode, line by line, very clean, 
structured assembly code can be generated. If this technique was 
carefully adhered to, routines containing hundreds of lines of code 
can be generated with few, if any, errors. 


2. General Comments 


The remainder of this summary details some of the other 
information that is not reflected in the pseudocode listings, such as; 
information about the A/D routine, A/D channel allocations. Signal 
Averaging and similar topics. 


I 

2.1. Analog t o Digital Converter Interrupt Routine 


As aresult of a negative transition on the 4 millisecond NMI 
line, the A/D interrupt handler gathers 13 channels of data, one at a 
time, and stores the results in memory. To accomplish this, the 
routine sets a mux channel address, waits for settling to occur, 
starts the conversion, polls for conversion complete, formats and 
stores the result and then repeats the process for each successive 
channel. In order to conserve time, the formating, which amounts to 
rearranging the word bit pattern and changing from sign magnitude to 
2's completement notation, is interleaved with the 80 microsecond 
conversion time of the next channel. 

The data read from the A/D is returned in 2 bytes, shown here 
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msbyte first: 


b? b6 b5 b4 b3 sign b9 b8 : bsy t1 sw2 swi w b2 -b1 bC 


where bX = data bit X 

sign = sign bit, "1" = negative 
bsy = A/D busy Line, "1" = done 
t1 = 30 minute alarm signal 
w = watchdog/panic interrupt line 
swi = inhibit switch, 
sw2 = motor thermostat 

which must be rearranged to the form: 

sign sign sign sign sign sign b9 b8 : b7 b6 b5 b4 b3 b2 b1 bO 


Notice the extended sign bit and the elimination of thi 
miscellaneous input bits. It is important to retain the other dati 
bits, which are used elsewhere, because random reads to the A/I 
(without a corresponding write, to initiate a conversion cycle) plact 
the A/D into an indeterminate state. Since these data bits ar« 
available during each read of the A/D, they are retained when the A/t 
is read during the seldom read channel and are stored in alarm 30 for 
use at a later time. 


_2.1_.1_. _A/_D C h a n n e I Allocations 

Channels are broken up into two groups, the *'o f t en- r e a d ' s " and 
the "seldom-read's". As implemented in version 1.X of the software, 
the first group contains 12 channels (i.e. 10 branch currents and the 
battery current and voltage) that are read every time the routine is 
called. The latter group contains all of the other channels and are 
read in a "round robin" fashion, one per pass thru the routine. The 
following is a list of the "of ten_r ead" and "s e I dom__r ead" channels 
showing the mux addresses and channel number associcated with each. 


OFTEN READ CHANNELS 


signal name 

mux 

often-read 


address 

channel number 

battery volts 

$00 

0 

battery current 

$20 

1 

branch #1 current 

$21 

2 

branch U2 current 

$22 

3 

branch #3 current 

$23 

4 

branch #4 cur rent 

$24 

5 

branch #5 current 

$25 

6 

branch #6 current 

$26 

7 
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branch 

#7 

current 

$27 ^ 

8 

branch 

#8 

cur rent 

$28 

9 

branch 

#9 

current 

$29 

A 

branch 

#1 0 

current 

$2A 

B 

“ 



SELDOM READ 

CHANNELS 


signal name 

mux 

se 1 dom- 

read 


address 

channe 1 

number 

branch #1 volts 

$01 

0 


branch #2 volts 

$02 

1 


branch #3 volts 

$03 

2 


branch #4 volts 

$04 

3 


branch #5 volts 

$05 

4 


branch #6 volts 

$06 

5 


branch #7 volts 

$07 

6 


'branch #8 volts 

$10 

7 


branch #9 volts 

$1 1 

8 


branch #10 volts 

$1 2 

9 


load bus # 1 volts 

$13 

A 


load bus # 2 volts 

$1 4 

B 


load bus # 3 volts 

$1 5 

C 


load bus # 4 volts 

$16 

D 


load bus # 5 volts 

$17 

E 


load bus #1 current 

$2B 

F 


load bus #2 current 

$2C 

10 


load bus #3 current 

$2D 

1 1 


load bus #4 current 

$2E 

12 


load bus #5 current 

$2F 

13 


battery temp 

$30 

14 


freezer temp 

$40 

15 


80% of Vref 

$50 

16 


zero voltage reference 

$70 

18 



2.1.2. Signal 


The raw, often_read channel data is stored (2's complement form) 
in a 12 X 16 WORD array based at of ten_read_base (at location $0320). 
The array is arranged in the following manner. The table shows the 
address at which the Isbyte of each reading for each channel of the 
"often read's" is stored. 
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Signal Averaging Array 


channel 

numbe r S-- 

> 


0 

1 

reading 

number 



1 1 

320 

340 

I 2 

322 

342 

I 3 

324 

344 

I ^ 

326 

346 

V 5 

328 

348 

6 

32A 

34A 

7 

32C 

34C 

8 

32E 

34E 

9 

330 

350 

10 

332 

352 

1 1 

334 

354 

12 

336 

356 

13 

338 

358 

14 

33A 

35A 

15 

33C 

35C 

16 

33E 

35E 


Note often read base = 


2 

3 

4 

5 

6 

360 

380 

3A0 

3C0 

3E0 

362 

382 

3A2 

3C2 

3E2 

364 

384 

3A4 

3C4 

3E4 

366 

386 

3A6 

3C6 

3E6 

368 

388 

3A8 

3C8 

3E8 

36A 

38A 

3AA 

3C A 

3E A 

36C 

38C 

3AC 

3C C 

3E C 

36E 

38E 

3AE 

3CE 

3EE 

370 

390 

3B0 

3D0 

3F0 

372 

392 

3B2 

3D2 

3F2 

374 

394 

3B4 

3D4 

3F4 

376 

396 

3B6 

3D6 

3F6 

378 

398 

3B8 

3D8 

3F8 

37A 

39A 

3BA 

3DA 

3FA 

37C 

39C 

3BC 

3DC 

3F C 

37E 

39E 

3BE 

3DE 

3FE 


$320 


7 8 9 ■ A 


400 

420 

440 

460 

4 

402 

422 

442 

462 

4 

404 

424 

444 

464 

4 

406 

426 

446 

466 

4 

408 

428 

448 

468 

4 

40A 

42A 

44A 

46A 

4 

40C 

42C 

44C 

46C 

4 

40E 

42E 

44E 

46E 

4 

410 

430 

450 

470 

4 

412 

432 

452 

472 

4 

414 

434 

454 

474 

4 

416 

436 

456 

476 

4 

418 

438 

458 

478 

4 

41 A 

43A 

45A 

47A 

4 

41C 

43C 

45C 

47C 

4 

41E 

43E 

45E 

47E 

4 


When 16 sets of data have been gathered the da t a s e t_r e ady_f L ag ii 
set. This flag is used as the handshake semaphore. While th( 
da t a se t_r e ady_f L a g = 1, the background program has not, as yet^ 
converted and used the last data set. When the da t a s e t_r e a dy_f I ag i< 
found to be asserted, the signal av routine, which runs in th( 
background, sums the 16 individual readings of each channel (i.e. on« 
of the above columns) and divides the result by 16 to produce ar 
average for that channel. This result is placed into the proper 
location in the dump state array. 


The calculation of t ot a l_c hg r_I , i.e. the total array current is 
done in this routine as well. Each of the branch currents is summed 
and the total is stored in the dump_state array as outlined below. 
Since the A/D reading of any given branch is a maximum of 10 bits, the 
sum of the 10 strings can never exceed the 16 bit word reserved for 
i t . 

All of the seldom_read channels are loaded directly into 
d u m p_a rray as they are read without signal averaging. 

The following figure shows the arrangement of the data in the 
"dump state" array. 
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2.1.3. A/D Channel Storage Loeat i ons 


original 

OF POOR 


UTY 


Often Read Channels: 


add r 

variable 

descript 

ion 

0008 

batter y_V : 

ave raged 

battery voltage 

OdOA 

ba 1 1 e ry_I : 

averaged 

battery current 

OOOC 

branchl : 

averaged 

branch 1 current 

OOOE 

b r a n c h 2 : 

ave raged 

branch 2 current 

0010 

br anch3 : 

averaged 

branch 3 current 

0012 

b ranc h4 : 

averaged 

branch 4 current 

0014 

b r a n c h 5 : 

averaged 

branch 5 current 

0016 

branch6 : 

averaged 

branch 6 current 

0018 

branch?: 

ave raged 

branch ? current 

001A 

b r a n c h8 : 

averaged 

branch 8 current 

001 C 

branch?: 

averaged 

branch 9 current 

001E 

branchIO: 

ave raged 

branch 10 current 

Se Idom 

Read Channels: 



0020 

br voltsi: 

branch 1 

voltage 

0022 

b r_vo 1 1 s2 : 

branch 2 

voltage 

0024 

b r_vo 1 1 s3 : 

branch 3 

voltage 

0026 

b r_v o 1 1 s 4 : 

branch 4 

voltage 

0028 

b r__vo It s5 : 

branch 5 

voltage 

002A 

b r_v 0 1 1 s 6 : 

branch 6 

voltage 

002C 

b r_vo Its?: 

branch ? 

voltage 

002E 

b r_vo 1 1 s8 : 

branch 8 

voltage 

0030 

b r_v 0 1 1 s9 : 

branch 9 

voltage 

0032 

b r_v 0 1 1 s 1 0 : 

branch 10 voltage 

0034 

bu s_vo 1 1 s 1 : 

load bus 

#1 voltage 

0036 

bu s_v 0 1 1 s2 : 

load bus 

#2 voltage 

0038 

bus volts3: 

load bus 

#3 voltage 

003A 

bus volts4: 

load bus 

#4 voltage 

003C 

bus voltsS: 

load bus 

#5 voltage 

003E 

■ bu s_amp s 1 : 

load bus 

#1 current 

0040 

bus amps2 : 

load bus 

#2 current 

0042 

bu s_amp s3 : 

load bus 

#3 cur rent 

0044 

bu s_amp s4 : 

load bus 

#4 current 

0046 

bus_amps5 : 

load bus 

#5 cur rent 

0048 

bat temp: 

battery 

temperature 

004A 

f r ez_t emp : 

freezer 

temperature 

00-4C 

V_r e f : 

reading 

of .8 Vref 

00 4 E 

zero ref : 

zero voltage reference 

0050 

tot a l_chg r_l : 

current 

total charger current 

Since the 4 millsecond 

interrupt is 

the only means for provi 


system timing, the one__second and 80_msec timers and flags are both 
controlled by this routine. Both timers (located in memory) are 
decremented each pass and reloaded when they reach 0. When either 


c - 
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©RIOWAL PAOi IS 
OF POOR QUALITY 


timer "times out"^ the respective flag is set to indicate to th 
background routine that the time period has elLapsed. 

Settle_time is set by the ma x_pwr_t r a ck routine every time that 
change is made to the PWM counters. If settle_time is non-zero,. aLL o 
the data gathering code in this routine is skirted. This gives th 
power module time to settle before data is again taken. 

This routine also invokes scan_kybd on each pass to handle th 
scanning of the hex keypad on the front panel. 


Operator Interface . 

The following four sections outline the functions that ar 
available to the user either via the hexadecimal keypad on the fron 
panel or the serial port (300 baud only). The channel numbers use 
for accessing the different quantities are as follows: (Note th- 
difference between the user channel number and the raw channel number, 
which is used only with the Q command through the serial port.) 


OFTEN READ CHANNELS 


signal 

name 

user c h 

user c h 

display 

raw c 




number 

number 

pattern 

numbe 




(serial) 

(keypad) 



battery 

' volts 

EOO 

ADO 

X X X . X 

ODD 

battery 

' current 

IDO 

BOO 

X X X . X 

001 

branch 

#1 

current 

101 

BD1 

X X . X X 

Q02 

branch 

#2 

current 

102 

B02 

X X . X X 

Q03 

branch 

PI 

cur rent 

103 

BD3 

X X . X X 

004 

branch 

#4 

current 

104 

B04 

X X . X X 

QOS 

branch 

P5 

c u r r e n t 

105 

BOS 

X X . X X 

006 

branch 

P6 

current 

106 

B06 

X X . X X 

007 

branch 

PI 

cur rent 

107 

B07 

X X . X X 

008 

branch 

#8 

current 

108 

B08 

X X . X X 

009 

branch 

P9 

cur rent 

109 

B09 

X X . X X 

010 

branch 

#1 0 

I cur rent 

no 

B1 0 

X X . X X 

Oil 



SELDOM 

READ CHANNELS 



signal 

name 

user ch 

user c h 

display 

raw c 




number 

numbe r 

pattern 

numbe 




(serial) 

(keypad) 



branch 

#1 

volts 

E01 

A01 

X X X . X 

Q12 

branch 

P2 

volts 

E02 

A02 

X X X . X 

013 

branch 

PI 

volts 

ED3 

A03 

X X X . X 

014 

branch 

#4 

volts 

E04 

A04 

X X X . X 

01 S 

branch 

#5 

volts 

EOS 

AOS 

X X X . X 

016 

branch 

#6 

volts 

E06 

A06 

X X X . X 

017 
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branch #7 volts 

E07 

A07 

XXX. X 

Q18 

branch #8 volts 

E08 

AOS 

X X X . X 

Q19 

branc9 #9 volts 

E09 

A09 

X X X . X 

Q20 

branch it'] 0 volts 

E01 

A10 

X X X . X 

Q21 

load bus #1 

volts 

E31 

A31 

X X X . X 

Q22 

load bus #2 

volts 

E3 2 

A3 2 

X X X . X 

Q23 

load bus #3 

volts 

E33 

A3 3 

X X X . X 

Q24 

load bus #A 

volts 

E34 

A3 4 

X X X . X 

Q25 

load bus its 

volts 

E3 5 

A3 5 

X X X . X 

Q26 

load bus #1 

cur rent 

131 

B31 

X X X . X 

Q27 

load bus #2 

current 

132 

B3 2 

X X X . X 

Q28 

load bus #3 

cur rent 

133 

B33 

X X X . X 

Q29 

load bus #4 

current 

134 

B34 

X X X . X 

Q30 

load bus #5 

cur rent 

135 

B3 5 

X X X . X 

Q31 

battery temp 


D36 

D36 

X X X . X 

Q32 

f reeze r temp 


D37 

D37 

X X X . X 

Q33 

80% of Vref 


E3 8 

A3 8 

X . X X X 

Q34 

zero voltage 

reference 

E39 

A3 9 

X . X X X 

Q35 

total charger current 

140 

B40 

X X X , X 

Q37 

state of charge 

DOO 

DOO 

XXX 

_ 

corrected state of chg 

D40 

D40 

XXX 

- 

equa l_count 


D41 

D41 

XXX 

- 

pwm_va lue 


D42 

D42 

XXX 

- 


The following are 

calculated at 

display time: 

signal 

name 

user c h 

user c h 

display 




number 

numbe r 

pattern 




(serial) 

(keypad) 


battery 

power 

POO 

COO 

X X X X X 

branch 

#1 

power 

P01 

C01 

X X X X X 

branch 

#2 

power 

P02 

C02 

X X X X X 

branch 

#3 

power 

P03 

C03 

X X X XX 

branch 

#4 

power 

P04 

C04 

X X X X X 

branch 

#5 

power 

P05 

COS 

X X X X X 

branch 

#6 

power 

P06 

C06 

X X X X X 

branch 

#7 

power 

P07 

C07 

X X X X X 

b r'a n c h 

#8 

power 

P08 

COS 

X X X X X 

branch 

#9 

power 

P09 

C09 

X X X X X 

branch 

#10 

1 power 

P10 

CIO 

X X X X X 


Hexadecimal Keypad Functions 

Some of the following functions, i.e. those noted with (mult), 
are "multimeter functions". This means that when this function is 
selected, every 320 msec the quality is measured, converted as 
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necessary and redisplayed. 

Definition of notation: 

a - any of the alphanumeric keys (i.e. not or 

nn - channel/device specification consisting of any two numeric keys 

mm or mmm - data specification consisting of any two or three numeric 

NOTE: all inputs are assumed to be "fixed format" i.e., if the specif 
calls for 3 digits, leading zeroes must be added to make the input 3 
long. 

2. 2. 1.1. Public Functions 


sequence 

function 

★ 

clear function 

a a a a A 

activate password-accessible functions 
if user password matchesCsee below) 

Ann# 

read channel nn voltage (mult) 

Bnn# 

read channel nn current (mult) 

Cn n# 

read channel nn power (mult) 

Dnn# 

read misc data channels (mult) 

AA# 

display software version number 

BB# 

reed time, hours and minutes (mult) 

CC# 

initiate "dump" of machine state to 
serial port 

DD# 

not used 


2. 2. 1.2. Password-Accessible Functions 


In order to access these functions, the user must have 
successfully entered the 4 character password 

sequence function 
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Anminni# 

Bnmmm# 

Cirimm# 

Drvnm# 


se^t load shed threshold for load n at mmm 
set load restore threshold for load n at mmm 
set the initial percentage SOC at mmm% 
set device nn to condition m, where m must be 




either a "1" 

(ON) 

o r 

a 

"0" 

(OFF) 

d e V i c e 

0 

audible alarm 






dev i c e 

1-6 

user load requests. 1 

thru 

6 


d e V i c e 

7-1 1 

overload trip 

resets 

for 

loads 1 thru 5 

devi ce 

12-17 

PWM buffer #1 

controls 

1 

thru 

6 

devi ce 

1 8-23 

PWM buffer #2 

cont ro Is 

1 

thru 

6 

devi ce 

24-25 

Yellow, and Red LEDs 






AA# 


initiate lamp and annunciator test 
(accessable only in test/cal mode) 


BB# 


toggle from run to test/cal mode 
(system comes up in the run mode) 


C C h hmm# 
DD# 


set time, hours and minutes 
cancel password authorization 


— • — ’ — ’ P^hiug Monitor Functions 

These functions are accessed via the serial port. They are 
listed in upper and lower case letters for comparison with the 
commands above. In order to permit maximum flexibility with respect to 
terminals, either case is useable in practice. 

sequence function 


“H, backspace, del 


“U 

“Z 

M<add r> 


Deletes last character entered. Echoes 
backspace, space, backspace to allow 
overwriting the last character entered 
when a CRT terminal is used. 

Causes CPU to ignore present command line 

Return to command mode 

Opens a memory location at the specified 
address (requires 4 hexadecimal digits). 
Successive " " (space) characters increment 
thru memory, while characters decrement 

thru memory. At any time the contents of 
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om&MA. WaQEi is 

OF POOR QUMTO 


G<add r> 


B<addr> 


a location may be altered by entering the 
new data followed by a carriage return. 

Begins execution at the specified address, 
no address is specified, execution begins 
the present PC location 

Places a breakpoint at the specified addre 
This trace mode will only work on code 
located in RAM. 


X 


Removes existing breakpoint. 


L<addr> This permits a program to be downloaded fn 

a host machine to memory starting at the 
specified address. 


F<start_addr end_addr datum> 

Fills the specified memory range with spec 
byte of data. 


_2.2._1_.^. Maintenance and Logging Functions 


Many of the following functions are essentially identical t 
those invoked from the hexadecimal keypad, the exceptions being thos 
comffiands requiring password authorization.. The main difference i 
that the system response is returned via the ser'ial port. This coul 
be used for data Logging by having an external device reouest th 
desired data. 

sequence function 


W<pwm. timer no.xduty cycle> 

Set the Power Module duty cycle to specified 
value. If duty cycle > max_pwm, the default 
duty cycle is set to max_pwm 

0<digit no.XvaLue> Display the value in the specified digit on t 

LCD display. 


En n 
Inn 
Pnn 
Dnn 


Read channel nn voltage 
Read channel nn current 
Read channel nn power 
Read misc data channels 


Qnn 


Query channel nn for "raw" A/D data 
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N 


Display software version number 


T 


Read time, hours and minutes 


S n m m m 
Rrtmmm 


Set Load shed threshold for load n at mmm 
Set Load restore threshold for Load n at mmm 


Ymmm 
J nnm 


A 

Z 


Set the initial percentage SOC at mmm% 

Set device nn to condition m, where m must be 
either a "1" (ON) or a "0" (OFF) 


dev i 

ce 

0 

audible alarm 





d ev i 

ce 

1-6 

user Load requests 1 

thru 

6 

devi 

c e 

7-1 1 

ove r load trip 

resets 

for 

loads 1 

devi 

c e 

12-1 7 

PWM buffer #1 

cont ro Is 

1 

thru 6 

devi 

c e 

18-23 

PWM buffer #2 

cont ro 1 s 

1 

thru 6 

devi 

c e 

24-25 

Yellow, and Red LEDs 





Initiate Lamp and annunciator test 
(accessable only in test/cal mode) 

Toggle between run and test/cal mode, note 
the system comes up in the test/cal mode 


Chhmm 

K 


Set time, hours and minutes 
Initiate "dump" of machine state 


2.3. Calculating And Interpreting System Parameters 


In order to calculate the hexadecimal values used for system 
parameters, it is first necessary to classify the type, because each 
type of parameter must be calculated somewhat differently. 

Currents are broken into two types. Battery and load currents 
have a maximum value of 102.3 amps while the branch currents have a 
maximum of 10.23 amps. Hence, full scale, i.e. $3 F F has two different 
meanings depending dn which current you are referring to. In the first 
case the reading corresponds to the number of "1/10's" of amps being 
measured, while in the second case to the number of "1/100's" of amps. 
Once the desired current has been expressed in the proper units, 
converting the decimal number to hexadecimal results in the correct 
parameter value. For example: 

1. battery_I = 82 amps 

= 820 "1/10's of an amp" 

= (3 * 256) + (3 * 16) + (4 * 1) 

= $0334 
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2. branchl = 7.2 amps 

= 720 "1/100's of an amp" 

= (2 * 256) + (13 * 1 6) 
= S02D0 


CalcuLating voltages is somewhat simpler because, with only 3 
exceptions, all voltages are baseci on a full range value of 409.2 
volts. As with the current measurements, most voltage readings 
represents the number of "1/10's of a volt". However, in the case of 
the thermister signals (frez_temp and bat_temp) and V_ref the raw A/D 
count represents the number of "1/1000's of a volt". A full scale 
reading of $3FF corresponds to 1023 (base 10). If this number is 
shifted left 2 places, $3FF becomes $FFC which corresponds to 4092. 
Hence, to convert from decimal volts to hexadecimal volts, divide the 
voltage by 4 and convert the result to hexadecimal. For example: 


1. V_ref = 4.092 volts 

= 4092 "1/1000's of a volt" 

4092/4 = 1023 

= (3 * 256) + (1 5 * 1 6) + (1 5 * 1 ) 

= S03FF 

2. abs_min_bat volt = 95 volts 

= 950 "1/10's of a volt" 

950/4 = 237 

= (14 * 16) + (13 * ,1) 

= SOOED 

Binary percentages for s t a t e_o f_c hg , equal_count and similar 
variables are represented by a 8 bit number with the binary point 
located 1 bit in from the MSB, as shown here. 

MSB 

x.xxxxxxx 

I 

binary point 


To calculate binary percentages, use this relation: 
binary % = ((decimal% * 128)/100) expressed in hexadecimal 
For example: 

1. maximum binary % = (100% * 128)/100 

= 128 
= (8 * 16) 

= $80 

2. shed th = (20% * 128)/100 
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= 26 

= (1 * 16) + (10 * 1) 
= $1A 


To calculate the constant used for state_of_chg use the following 
relation: 

i sea l_bat_cap = 5.49 * 10“10 * iscal * 1/bat_cap 

For example, if iscal = 1/45000 and bat_cap = 40 A-H then, 

i sea l_bat_cap = 5.49 * lO'IO * (1/(45000 * 40)) 

= 30470 

3. Append i x #1 - Generating System Lookup Tables 


Appendix 1 contains copies of the programs, written in the "C" 
programming language, for the generation of tables to speed the 
calculation of those variables involving corrections for battery 
temperature. "C" is commonly used in academic circles and is becoming 
quite popular in industry. It was used for generation of the values 
since it is the normal language used here at MI/CEC. The algorithms 
are quite straight-forward and can be easily translated to BASIC or 
any other language of choice. For the details of the Lookup 
technique, refer to the Pseudocode listings for the appropriate 
tables. The first program generates tables for float voltage, 
equalization voltage and minimum battery voltage, while the second 
generates the table of values for use with the corrected state of 
charge routine. Notice that the program outputs each of the tables in 
two different formats; human readable and machine readable. For 
examples of the output, see the pseudocode Listings for c a I c_s y s_v o 1 1 s 
and correct stat of chg. 
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PROGRAM #1 “ Generates tables for ■float_V, equal_V and min bat V. 

# include <math.h> 

^include <stdio.h> 
main( ) 

{ 

int j/ i^ V, t; 

float x; 

double value, temp; 

/* NOTICE!!! THE CONSTANT 2.5 FOUND IN THE EQUATIONS BELOW COMES FROM 
THE FACT THAT THE VOLTAGES ARE STORED IN A FORM THAT IS EQUAL TO 
THE NUMBER OF TENTHS OF VOLTS. FOR DISPLAY THIS VALUE IS MULTIPLI 
BY 4, SINCE $3FF --> 1023 --> 409.2 VOLTS. 


so, stored value = (input volts * 10)/4 

or, stored value = (input volts * 2.5) */ 


print-f ("\n\t\tFL0AT VOLTAGE TABLE\n\n"); 
for(i=0xD;i <= 66; i=i+1) 

{ 


temp = 25-. 02092* ( (64*i )-2560) ; 

value=2.4 * 54 * 2.5 * (1 + (.0022 * (25-temp))) 
t = i * 6 4 ; 
v = va I ue ; 

value=value * .4; 

printf ("%4.0f deg C \ t %02 x \ t %03 x \ t %0 4 x \ t %4 . 1 -f \ n " , 

i-0xD,t,v,value); 


> 


temp 


/ 


print-f ("\n") ; 
for(i=0xD;i <= 66; i=i+8) 
■C 


printf(".word\t") ; 
for(j=0;j <= 7;j=j+1) 
•C 


temp = 25-.D2D92* ( (64* (j+i ) )-2560) ; 
value=2.4 * 54 * 2.5 * (1 + (.0022 * (25-temp) 
v=va I ue ; 

pr i nt f ( "$%04x, ",v); 

> 


printf("\n") ; 

> 

printf("\14") ; 

printf ("\n\t\tEQUALIZATION VOLTAGE TABLE\n\n"); 
for(i=0xD;i <= 66; i=i+1) 


temp = 25-. 02092* ( (64*i )-2560) ; 

value=2.5 * 54 * 2.5 * (1 + (.0022 * (25-temp))); 
t = i *64; 
v = va lue; 

value=value * .4; 

printf (*'3:4. Of deg C \ t X02x \ t X03 x \ t %04 x \ t %4 . 1 f \ n" , t emp , 

i-0xD,t,v, value); 

> 

pr i nt f { " \n") ; 
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> 


for(i=OxD;i <= 66; i=i+8) 

■C 

pn'ntf(".word\t") ; 
for(j=0;j <=7;j=j+1) 
•C 



temp = 25-.02092*((64*(j+i))-2560); 

value=2.5 * 54 * 2.5 * (1 + (.0022 * (25”temp))); 

v=va lue; 

printf ("$%04x, "^v); 

> 


printf("\n"); 

> 

printf("\14"); 

printf ("\n\t\tMINlMUM BATTERY VOLTAGE TABLE\n\n"); 
for(i=0xD;i <= 66; i=i+1) 

< 


temp = 25-. 02092* ( (64*i )-2560) ; 

vaLue=1.9 * 54 * 2.5 * (1 + (.0022 * (25-temp))); 
t = i * 6 4 ; 
v = va Lue; 

va Lue = va Lue * .4; 

printf ("%4. Of deg C \ t %02 x\ t %03 x \ t %04 x \ t %4 . 1 f \ n " , t emp , 


printf("\n"); 
for(i=0xD;i <= 66; i=i+8) 
■C 


printfC'.wordXt") ; 
for(j=0;j <= 7;i=j+1) 

•C 

temp = 25-.02092* ( (64* (j+i ) )-2560) ; 

vaLue=1.9 * 54 * 2.5 * (1 + (.0022 * (25-temp))); 

v = va Lue; 

printf ("$%04x, ",v); 

> 

printfC’Xn") ; 

> 


PROGRAM #2 - Generates tabLe for c o r r e c t_s t a t e_o f_c hg . 

SincLude <math.h> 

#incLude <stdio.h> 
ma i n ( ) 

{ - 

int j, i/ V, t; 

fLoat X, coeff; 

doubLe vaLue, temp; 

printf ("\n\tC0RRECT STATE OF CHARGE TABLE\n\n") ; 
for(i=0xD;i <= 66; i=i+1) 

temp = 25-.02092*((64*i)-2560); 
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> 

% 


if ( t emp > 25) 

coeff = .0022; 

else 


coeff = .0075; 

vaLue=256 * (1 + (coeff * (temp-25))); 

t=i*64; 

v=va lue; 

value=value/2.56; 

printf ("%4.0f deg C \ t X02x \ t %03 x \ t %04 x \ t %4 . Of *4 %\ n '• 


> 


i-0xD,t,v, value); 


/te 


pr intf ("\n”) ; 
for(i=0xD;i <= 66; i=i+8) 
{ 


p r i nt f (•' . wo rd\ t " ) ; 
for(j=0;j <= 7;j=j+1) 
C 


temp = 25-.02092* ( (64* (j+i) )-2560) ; 
if (temp > 25) 

coeff = .0022; 

else 

coeff = .0075; 

value=256 * (1 + (coeff * (temp-25))); 
t = i * 6 4 ; 
v=va Lue; 

printf C‘SXD4x, ",v); 

> 

p r i n t f ( " \ n " ) ; 

> 
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4. Appendi x #2 - Pseudocode L i s't i n g s 


The following is a table of contents for the pseudocode listings. 
Note that the order of modules is the same as in the machine code 
PROMs. 

TABLE OF CONTENTS FOR PSEUDOCODE LISTINGS 
module name page no. 


abs_cnvt 

31 

adc hnd 1 r 

64 

a_t o_h 

5 

battery state_of_chg 

66 

break 

41 

b f d i V 1 0 

32 

calc equal count 

73 

calc sys volts 

66 

calc state_of_chg 

72 

chk for ovrld 

76 

cmd intrp 

63 

cnt r 1 pwm_out put 

54 

c 0 r r e c t_s tat e_o f _c h g 

73 

d e t e r_m a c h_s t a t e 

78 

d i s c r e t e_a r r a y_c n t r 1 

77 

d i s p 1 ay_c 1 r 

10 

d i s p 1 a y_d i g i t s 

10 

d i s p 1 ay_e r r o r 

9 

d i sp 1 ay_hnd 1 r 

8 

di splay_huh 

9 

do 0 watts 

21 

do p watts 

21 

d_t o_h 

7 

dump_amps 

24 

dump_a r rays 

58 

dump soc 

56 

dump_state 

44 

dump sw states 

57 

dump_t emp 

26 

dump_total_I 

32 

dump volts 

23 

dwn 1 d 

47 

fill 

46 

find amps 

16 

find pe r cent 

30 

find prod 

55 

f i n d_t i m e 

12 

f i nd_t emp 

27 

fin d_v 0 1 1 s 

14 

find watts 

20 

getbyte 

3 

get data 

4 
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go 

_h_nyb_t o_a 
h_t o_a 
h_t o__d_wo rd 
key__i nt rp 
ki I l_pas sword 
tamp_test 
m a x_p owe r_t rack 
mp__d i V 
nip_mu L t 
msg_hnd I r 
msg_hnd L r_wo 
multimeter func 
open_mem 
out_t i me 
out_amps 
out_c so c 

ou t_d ata_channe I 

out_equa L 

out_pwm 

ou t__s o c 

out_ve r s i on 

out_vo Its 

out_wa 1 1 s 

put_amps 

put by t e 

putbyte_wo 

put c ha r 

p ut c h a r_wo 

put_c s o c 

pu t_da t a_c h a n ne L 
put_equa I 
put_huh 

put_out_of_r ang e 
put_pwrii 

put_raw_c hanne L 
put_s 0 c 
p ut_t i m e 
put_t emp 
put_ve r s i on 
put_vo L t s 
put_wa 1 1 s 
r em_b r kpt 
run_task_master 
s ca n_k ybd 
seri a L_port 
set__b i t 
set_brkpt 
set_di git 
set_duty_cyc le 
set_i nit soc 
set_load_s hed 
s e t_l oad_r e s t o r 
set__tim kybd 


41 

6 

6 

6 

38 

43 
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61 
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1 1 

3 

3 

35 
35 
13 
1 5 
18 
16 
1 8 
1 8 
1 8 
49 
13 
19 

24 
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5 
3 
2 

22 

21 

22 

2 

2 

23 

25 
22 

25 

26 

48 
23 
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43 
60 
36 
39 
52 
42 
10 

49 
30 
29 
29 
28 
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shed_restor_Loads 75 
shift_L4 6 
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sp_mult 49 
test(initiaLization) 79 
test_st ri ng_I 56 
togg Le run bit 43 
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putchar: 

disable system interrupts; 
call pu t c h a r_wo ( a c cum ) ; 
enable system interrupts; 
end putchar; 


This routine places the string defined by the starting address 
and place it, character by character into the output buffer by 
the putchar routine that does not re-enable system interrupts. 
This routine is used in the serial port handler. 


in string p 
calling 
putchar wo. 


Pseudocode : 

msg_h nd I r_wo : 

save regs; 
i = 0; 

do while ( s t r i ng_p t r T i D <> 0) 

call putchar_wo(string ptrCiD; 
i = i + 1; 

end; 

unsave regs; 
end msg hnd I r wo; 



; This routine is identical to the above, except that it uses putchar instea 
; of putchar_wo and is to be used under normal string output circumstances. 



Pseudocode: 


m s g_h nd I r : 

save regs; 
i = 0 ; 

do while ( s t r i ng_p t r C i 3 <> 0) 

call put c h a r ( s t r i ng_pt r C i 3 ; 
i = i + 1 ; 

end; 

unsave regs; 
end msg hndlr; 



; This routine retrieves the next two ascii characters in the command_buf f er 
; converts them into a single hexadecimal value and return it via the 
; accumulator. Should either of the characters be something other than 
; 0-9, a-f or A-F; the ascii hex flag is cleared. 



Pseudocode : 


getbyt e : 

save regs; 

accum = command bufferCcmd in_ptr3; 
cmd_in_ptr = cm'3_in ptr + T; 
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call a_t o__h ( a c cum) ; 
if (a c cum <> $ F F) 
then do; 

temp = accum << 4; 

accum = command_buf f erCcmd_i n_pt rH; 
cmd_in_ptr = cmd in_ptr +1; 
call a_t o_h (a c cum ) ; 
if (accum <> $FF) 
then do; 

accum = accum + temp; 
a s c i i_hex_f I ag = 1; 

end; 

else a s c i i_h e x_f L ag = 0; 

end; 

else ascii_hex_f lag = 0; Oil«AL PilCIE IP 

unsave regs; OE TOOi QUM.ITf 

end getbyte; 


This routine retrieves the next two ascii characters in mu L t i m e t e r_d a t 
converts them into a single hexadecimal value and return it via the 
accumulator. Should either of the characters be something other than 
0-9, a-f or A-F; the a s c i i_h e x__f I ag is cleared. In this way it is aim 
identical to the previous routine, except for the location that the 
data is retrieved from. This routine is used by multimeter func. 

* ★ ★ ★ 


Pseudocode : 


g e t_d a t a : 

save regs ; 

accum = multi mete r_d a t a ; 
call a_t o_h ( a c c urn ) ; 
if (accum <> $FF) 
then do; 

t emp = accum << 4; 
accum = mu 1 1 i me t e r__d a t a + 1; 
call a_t o_h ( a c cum) ; 
if (accum <> $FF) 
then do; 

accum = accum + temp; 
asc i i_hex_f I ag = 1; 

end; 

else a sc i i_hex_f I ag = 0; 

end; 

else a s c i i_h e x_f I ag = 0; 
unsave regs; 
endgetdata; 


This routine takes the hexadecimal value in the accumulator, converts 
it into two ascii characters and places them into the output buffer. 
This routine assumes that the system interrupts are to remain disabled^ 
so that it uses putchar wo instead of putchar. 
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Pseudocode : 

putby t e_wo : 

call h_t o_a ( a c cum) ; 
call put c h a r_wo ( a s c i i_c h a rs + 1 ) ; 
call put c h a r_wo ( a s c 1 i_c ha rs) ; 
end putbyte wo; 



; This routine takes the hexadecimal value in the accumulator, converts 
; it into two ascii characters and places them into the output buffer. 

; This routine wants to turn off the system interrupts so that the serial po 
; handler cannot interfere so it uses putchar instead of putchar wo. 



Pseudocode : 


putbyte: 

call h_t o_a ( a c Cum ) ; 
call pu t c h a r ( a s c i i_c h a r s+1 ) ; 
call pu t c h a r ( a s c i i_c h a r s) ; 
end putbyte; 



; This routine converts the ascii character contained in the accumulator to 
; the corresponding hex value which is returned in the accumulator. If the 
; character is something other than 0-9, a-f or A-F; $FF is returned instead 



Pseudocode : 


a_t o_h : 

save regs; 
if (accum >= $30) 
then do; 

if (accum <= $39) 

then accum = accum - $30; 
e I s e do; 

accum = accum AND $DF; /* force to upper case */ 
if ((accum >= $41) AND (accum <= $46)) 
then accum = accum - $37; 
elseaccum=$FF; 

[ end ; 

end; 

elseaccum=$FF; 
unsave regs ; 
end a to h; 



; This routine converts the hexadecimal value contained in the accumulator 
; into two ascii characters for transmission. The two characters are stored 
; in the word value, ascii chars 



Pseudocode ; 
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h_t o__a ; 

save regs; 

temp = accum; 

call _h__nyb_to_a (a c cum) ; 

Isbyte of ascii_chars = accum; 
call _h_nyb_to_a (temp >> 4); 
msbyte of ascii_chars = accum; 
unsave reg; 
end h to a ; 



; This captive subroutine converts the lower nybble of the accumulator 
; into the corresponding ascii character and returns it in the accumuLet 



Pseudocode: 


h_nyb_t o_a ; 

accum = accum AND $0F; 
if (accum < $A) 

then accum = accum + $30; 
else accum = accum + $37; 
end h nyb to a; 


; This subroutine shifts the contents of dec value into the accumulator 
; 4 bits at a time, and converts the nybble Tnto ascii by clearing the uc 
; nybble and adding $30. It is assumed that only decimal digits will be 
; in dec value. 


Pseudocode : 
s h i f t_L4 : 

shift dec_value << 4; 
place 4 msb's into accum; 
accum = accum AND $0F; 
accum = accum OR $30; 
end shift L4; 


This routine converts the 16 bit hexadecimal word contained in the cnvt 
into a packed decimal word that is returned in dec value. 


Pseudocode : 

h_t o__d_wo rd : 

save r egs ; 
dec_value = 0; 

mem^byte = (Isbyte of cnvt__data) AND $0F 
if <mem_byte <> 0) 

then dec_value = t ab I e__1 Cmem_by t eD ; 
mem_byte = ((Isbyte of cnvt__data) AND $F0) >> 4; 
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if (me m_b y t e <> 0 ) 

then d e c_v a L u e = d e c_v alue + tabl e_1 6 C m e m_b y t e D ; 
mem_byte = (msbyte of cnvt_data) AND $0F 
if (mem_byte <>0) 

then dec_value = dec_value + t ab I e_2 56Cmem_by t eD ; 
mem_byte = ((msbyte of cnvt_data) AND $F0) >> 4;' 
if (mem_byte <>0) 

then dec_value = dec_value + t ab L e_4096Cmem_by t eU ; 
unsave regs; 
end h to d word; 



HEXADECIMAL TO DECIMAL CONVERSION TABLES 




table 1 : 


.byte 

$00, $01, $02, $03, $04, $05, $06, $07 


.byte 

$09, $10, $11, $12, $13, $14, $15 

table 16: 


.word 

$0000, 

$0016, $0032, $0048, $0064 


.word 

$0080, 

$0096, $0112, $0128, $0144 


.word 
• word 

$0160, 

$0240 

$0176, $0192, $0208, $0224 

table 256: 


.word 

$0000, 

$0256, $0512, $0768, $1024 


.word 

$1 280, 

$1536, $1792, $2048, $2304 


.word 
• word 

$2560, 

$3840 

$2816, $3072, $3328, $3584 

table 4096: 


.byte 

$00, $00 

,$00, $96, $40, $00, $92, $81, $00 


.byte 

$88, $22 

,$01, $84, $63, $01, $80, $04, $02 


.byte 

$76, $45 

,$02, $72, $86, $02, $68, $27, $03 


.byte 

$64, $68 

,$03, $60, $09, $04 


; This routine is used to convert the packed decimal byte in the accumulator 
; into its hex equivalent. If either nybble is > $9, the over 10_flag is se 
; The result is returned via the accumulator. To accomplish t¥ is, the most 
; significant nybble is multiplied by 10 and added to the least significant 
; nybble. 


Since 10X = (2 + 8)X = 2X + 8X, 
10X = X(shifted left by 1) 
trick: 10 * X = (8 * X) 


t follows that: 

+ X(shifted left by 3) 
+ (2 * X) 


Pseudocode : 


d_t o_h : 

save regs; 
tempi = accum; 
o V e r_1 0_f lag = 0 ; 
accum = accum AND SFO; 
if (a ccum < $A0) 
then do; 

temp2 = (accum >> 1) + (accum >> 3); 
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d 1 s p L a y_d i g i t s : 

save regs; 

dsply_port = #dsply__c Lk_of f OR dsply sel dsb; 
dsply__port = dspLy_port AND #dsply_sel enb; 
do i = 0 to 4 

temp = digitsCiD; 
do j = 0 to 7 

if (digitsTi^ AND #$01) 

then dsply__port = dsply__port OR #send 1_bit; 
else dsply_port = dsply_port AND # s e n'd_0_b i t ; 
digitsCiD = digitsTiD >> 1; 
dsply_port = dsply_port OR #dsply_clk_on; 
dsply_port = dsply_port AND # d s p I y_c L k_o f f ; 

end; 

digitsCi] = temp; 

end; 

dspLy_port =dsply_port OR #ds p I y_s e l_d s b ; 
i_o_flags = i_o_flags AND #lcd_dspLy dun; 
unsaveregs; ~ 

end display digits; 



; This routine will set up the array display_word with "blanking" inform; 
; in all digits, and then call d i sp I ay_h nd I r ( ) in order to clear the LCD 
; display. 



Pseudocode : 


d i s p I a y_c I r : 

save regs; 

d i sp I ay_wo rdCAD =0; 
di sp I ay_wo rd[3D = #$80; 
d i sp I ay_wo r dC 23 = #$80; 
di sp I ay_wo r dC 1 3 = #$80; 
di spl ay_wordH03 = #$80; 
call di spl ay_hnd I r ; 
unsave regs; 
end display clr; 


This routine, called from the terminal, allows the user to set one digit 
of the LCD display to a specified character, while blanking the rest of 
the display. The accessible digits are the rightmost 4, and they are 
number 1-4 starting from the right 


Pseudocode : 

s e t_d i g i t : 

save regs; 

if ( (command__buf f erCI 3 < $31) OR ( c omma nd_buf f e r Cl 3 > $34)) 
then calT msg__hnd I r ( ' INVALI D LCD DIGIT NUMBER'); 
else do; 
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i = command_buf f erCI 3 - #$31; 

if ( (command_buf f erC23 < $30) OR ( ( c ommand_bu f f e rC23 > $39) 
AND (command_buf f erC23 < $41)) OR 
(command_buf f erC23 > $46)) 
then call msg_hnd I r ( ' D I G IT OUT OF RANGE'); 
e I s e d 0 ; 

j = command bufferC2D - #$30; 
if(j > $09) 

then j = j - #$07; 
mu 1 1 i me t e r_f I ag = 0; 
do k = 3 to 0 step -1 ; 

display_wordCk3 = #$80; 
di splay_wo rdC43 = 0; 
d i sp I ay_wo rdC i 3 = j; 
call d i s p I ay_h nd I r; 

end; 

end; 

end; 

unsave reg; 
end set digit; 


This routine is an unsigned multiply that takes the two 16 bit words in 
multi and mult2 and produces a 32 bit product which is returned, 
surprisingly enough, in "product". The technique used is the commonly 
used shift and add algorithm. 


seudocode : 


p_m u 1 1 : 

save regs; 

product =0; { Zero out product memory location > 

scratch = mult2; -C Load multiplicand into lower 2 bytes > 

•C of scratch area in memory > 

■C Zero out upper two bytes of scratch area > 
do y index = 0 to 1; ^ For both lower & upper byte of multiplier 3 


accumulator = multi + y_index; 
do x_index = 8 to 0 step -1 
accum = accum >> 1; 

if ( c a r r y_b it = 1 ) 
then do; 

product— product 


scratch << 1; 

end; 

end; 

end; 

unsave regs; 
end mp mult; 


•C get the multiplier byte > 

< For each bit in the byte > 

•C shift it right to see if bit > 
■C is set.... > 

■C If so, then ...> 

+ sc ratch; 

•C add (shifted) multiplicand > 

■C to product > 

•C In any case, shift the > 

•C go to next bit of multiplier 3 
•C get next byte of multiplier 3 


This routine is au unsigned multi precision division where the 32 bit 
dividend is stored in, get this, dividend; and the 16 bit divisor is 
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To 


stored in divisor. The algorithm used was 
subtract. The quotient is- retur ned. . . yep^ 

As for the remainder^ well you get the picture, 
page/, quotient and remainder overlay dividend. 

In order to test to see if there will be an overflow, i 
will be bigger than 16 bits we compare the divisor with 
of the dividend. If the dividend is less, then we're 
two bytes can be no more than 32768 * the divisor and 
divsion must then be less than 32768 (16-bits, max.). 


a "brute force" shift and 
you guess it. ..in quotient. 

save space in zerc 


e. if the quot 
the upper two 
OK, since the up 
the result of th 


Pseudocode : 




mp_d 1 V : 

save regs; 
if divisor = 0 

then se t_d i v_by_f I ag ; 
else do; 

if (dividend > SFFFF * divisor) 
then s e t_d i v_o ve r f I ow_f I ag ; 
e I s e do ; 

tempquot = 0; zero out temporary quotient ar 

tempdivr = divisor * $10000; 

■C upper two bytes of tempdivr get divis 
•C and lower two bytes get 0 > 
for x_index = 2 to 1 step -1 { Do two bytes wor 

for bit_cntr = 8 to 1 step -1 

< Do a shift for each bi 

tempqout << 1 ; 
t empd i V r >> 1 ; 

tempdiff = dividend - tempdivr; 

•C Long word operation > 
if (tempdiff >= 0) 
then do; 

tempquot = tempquot + 1; 
dividend = tempdiff; 

< Make subtraction real 

end; 

end; 

end; 

quotient = tempquot;{ load up quotient in correct ar 
end; 

end ; 

unsave regs; 
end mp div; 


This routine reads the contents of the Time of Day counters in the 
Am9513 timer and stores the hours and minutes information away in zero 
locations "minutes" and "hours" for use by out time and put time. 


Pseudocode : 

fin d_t i m e : 

save regs; 
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timer_csr = #$A3; 
timer_csr = /#$19; 
i = time r__d a t a ; 
i = i OR time r_d a t a ; 
if (i = 0) 
then do; 

timer__csr = #$A2; 
timer_csr = #$1A; 

end; 

minutes = time r_d a t a ; 
hours = timer_data; 
unsave regs; 
end find time; 


This routine reads the contents of the zero-page Locations "minutes" and 
"hours" and formats the information for display on the LCD display. 


seudocode : 

u t_t i me : 

save regs ; 

dispLay_word = minutes AND #$0F; 
d i sp L ay_wo rd+1 = ((minutes AND #$F0) >> 4); 
di sp L ay__wo rd + 2 = hoursAND#$0F; 
di spLay__word + 3 = ((hours AND #$F0) >> 4); 
d i sp I a y_wo r d + 4 = #$02; 
call d i s p I ay_h nd L r ; 
unsave regs; 
end out time; 


This routine locates the "raw A/D count" for a specified channel and 
converts it into decimal volts and formats the value for the front panel 
display. 


5 uedocode : 

it__vo Its : 

save regs; 

mem_byte = get_data(); 
if ( a sc i i_hex_f I ag = 1) 
then do; 

call find_voLts; 

if ( e r r o r_f I a g = 0 ) ' 

then do; 

dec_value = h__t o_d_wo rd ( c nvt_da t a) ; 
if (dec__value >= 10000) 
then do; 

accum = $03; 

call displa y_e r r o r ; 

end; 

else do; 
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end; 


do index = 3 to 0 step -1; 
call shif t_L4 ; 

di sp I ay_wo rdC i ndexD = accum; 

end; 


end; 

d i s p I ay_wo rdC4D = dot__po s i t i on; /* this includes 

sign flag dat 

call displa y_h n d I r ; 


end; 

else call display_huh; 
unsave r eg; 
end out volts; 


******* 


This is the subroutine which actually does the location of the "raw A/I 
count" for a specified channel from the dump array, put volts or out v( 



Psue decode: 

f i nd_vo Its: 

save regs; 

if (mem_byte <= S39) 
then do; 

if ((mem__byte = $38) OR (mem_byte = $39)) 
then dot_position = 3; 
else dot_position = 1; 
merr_byte = v o 1 1 ag e_c h a nn e I s Cmem byteT; 
if (mem_byte <> $FF) 
then do; 

e r r 0 r_f lag = 0; 

envt^data = dump arrayCmer" byte*23; 
if ( c nvt_dat a < 'U) 
then do; 

cnvt_data = 2's comp (cnvt_data); 
s i g n_f lag = 1 ; 

end; 

else sign_flag = 0; /* sign flag is in msb of 

d ot_po sition * / 

cnvt_data = cnvt__data << 2; 

end; 

else erro r__f lag = 1 ; 

end; 

else error_flag = 1; 
unsave regs; 
end find volts; 


USER VOLTAGE CHANNNEL LOOKUP TABLE 


voltage channels 


byte 

byte 
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• byte 

$1 5, 

$FF, 

$FF, 

.byte 

$FF, 

$ff'. 

$FF, 

.byte 

$FF, 

$FF, 

$FF, 

.byte 

$FF, 

$FF, 

$FF, 

.byte 

$FF, 

$16, 

$17, 

. byte 

$22, 

$23 



$FF, 

$FF, 

$FF, 

$FF, 

$FF 

$FF, 

$FF, 

$FF, 

$FF, 

$FF 

$FF, 

$F F, 

$FF, 

$FF, 

$F F 

$FF, 

$FF, 

$FF, 

$FF, 

$FF 

$18, 

$19, 

$1 A, 

$FF, 

$F F 



; This routine locates the "raw A/D count" for a specified channel and 
; converts it into decimal ampss and formats the value for the front panel 
; display. 



Pseudocode : 


out_amps: 

save regs ; 

mem_byte = get_data(); 
if ( a s c i i_h e x_f I ag = 1) 
then do; 

if (me m_b yte = $A0) 
then do; 

cnvt_data = abs_tot a l_c hg r I; 
dot_po sit ion = 1; 
if (total_chgr_I < 0) 

then s i g n_f lag = 1 ; 
dec_value = bf_di v1 0( cnvt_dat a) ; 

end; 

else do ; 

call f i nd_amps ; 
if (error_flag = 0) 

then dec_value = h_to_d_wo rd( cnvt_data) ; 

end; 

if (dec_value >= 10000) 
then do; 

error_num = $03; 
call displa y_e r r o r ; 

end; 

else do; 

do index = 3 to 0 step -1; 
call s h i f t_L4 ; 

d i sp I ay__wo rdC i ndex3 = accum; 

end; 

di splay_wordCAD = dot_po s i t i on; 
call displa y_h n d I r ; 

end; 

end; 

else call display_huh; 
unsave reg; 
end out amps; 


This is the subroutine which actually does the location of the "raw A/D 
count" for a specified channel from the dump array, put amps or out amps. 
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Pseudocode : 

find^amps; 

save regs; 

if (mem_byte <= S35) 
then do; 

mem__byte = cur rent_channe Is Cmem byteH; 
if (mem_byte <> $FF) 
then do; 

if <(mem_byte <= S10) AND (mem_byte <> 0) 
then do t_p osition = 2; 
else dot_position =1; 
e r ro r_f lag = 0; 

cnvt_data = dump_a r ray Tmem byte*2D; 
if (cnvt_data < 0) 
then do; 

cnvt_data = 2*s c omp ( c n vt_d a t a ) ; 
sign_flag = 1; /* sign bit is ms bit o 

dot_po s i t i on * / 

end; 

else sign_flag =0; 

end; 

else error flag = 1; 

end; 

else e r r o r_f lag = 1 ; 
unsave regs; 
end find amps; 



USER CURRENT CHANNNEL LOOKUP TABLE 



current channels: 


• byte 

$01 , 

$02, 

$03, 

$04, 

$05, 

$06, 

$07, 

$08 

.byte 

$09, 

$0A, 

$FF, 

$F F, 

$FF, 

$F F, 

$FF, 

$FF 

.byte 

$0B, 

$F F, 

$FF, 

$FF, 

$F F, 

$F F, 

$FF, 

$F F 

.byte 

$FF, 

$FF, 

$F F, 

$F F, 

$FF, 

$F F, 

$F F, 

$F F 

.byte 

$FF, 

$FF, 

$FF, 

$F F, 

$F F, 

$F F, 

$FF, 

$F F 

.byte 

$F F, 

$FF, 

$F F, 

SFF, 

$FF, 

$F F, 

$FF, 

$F F 

.byte 

$F F, 

$1B, 

$1 C, 

$1 D, 

$1 E, 

$1 F 




This routine displays or arranges for the display of 6 data channels t 
the front panel LCD display. The data channels are: 
channel 00 - state of charge 
battery temp 
freezer temp 

corrected state of charge 
equalization count 
pwm v a I ue 


channel 36 
c hanne I 37 
channe I 40 
channel 41 
channe I 42 


Pseudocode : 


out_data__channe I : 
save regs; 
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mem byte = get_data(); 
if Ta s c i i_h ex_f L ag = 1) 
then do; 

if (mem_byte = 0) then call out_soc; 

else if (mem_byte = $40) then call out_csoc; 

else if (mem__byte = $41) then call out_equal; 
else if (mem_byte = $42) then call out_pwm; 
e Ise do; 

call f i nd__t emp ; 
if (error__flag = 0) 
then do; 

if ( (d i v_by_ze ro = 0) AND (d i v_o ve r f I ow) 
then do; 

dec_value = h_t o^d_wo rd ( c nvt_da t a ) ; 
if (dec_value >= 10000) 
then do; 

a c cum = $06; 
call display error; 
end; 

else do; 

do index = 3 to 0 step -1; 
call shif t_L4 ; 

di spl ay_wo rdC i ndex3 = accum; 
end; 

d i sp I ay_wo rdC4D = dot_po s i t i on; 
call displa y_h n d I r ; 
end; 

end; 

else do; 

error_num = $06; 
call displa y_e r r o r ; 
end; 


end; 

else call display_huh; 

end; 

else call display_huh; 
unsave regs ; 
end out data channel; 


0 ) 


This routine locates the msbyte of state__of^c hg, estate of__chg, pwm__value^ 
or equalization count (depending on the entry point), converts it into a 
percentage and returns the value in dec__value ready for shifting and output 

State_of_chg is stored: X.XXX XXXX XXXX XXXX 

implied binary point 

Where this value represents (decimal percent) /1 00) * 32768 

To convert back to decimal for display, we first multiply by 200 (base 10) 
resulting in: 

(decimal pe r c ent age/ 1 00) * 32768 * 2 * 100 = (decimal percentage) * 65566 
So, by taking the msbyte of the result, rounding it up or' down by looking 
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at the msb of the previous byte, and converting to decimal we have a v. 
for output. Although the pseudocode shows this to be 5 separate routii 


in the assembly code they 


condensed 


just one, with 


entry poin' 


Pseudocode: 

out^c so c : 

save regs ; 

msbyte of multi = msbyte of c st a t e_o f_c hg ; 

Isbyte of multi = $80; 
call __di spl ay_soc ( ) ; 
unsave regs; 
end out_csoc; 

out_so c ; 

save regs; 

msbyte of multi = msbyte of s t a t e_o f_c hg ; 

Isbyte of multi = 2nd msbyte of state of chg; 
call _di spl ay_soc ( ) ; ~ “ 

unsave r egs ; 
end out_soc; 

out__equa I ; 

save regs; 

msbyte of multi = msbyte of equal count; 

Isbyte of multi = 2nd msbyte of equal count; 
call _di spl ay__soc ( ) ; ~ 

unsave r egs ; 
end out_equal; 

out__pwm : 

save regs; 

msbyte of cnvt_data = 0; 

Isbyte of cnvt_data = pwm_value >> 2; 
call _d i s p L a y_p wm : 
unsave regs; 
end out_pwm; 

_d i sp I ay__so c : procedure; 
mult2 = 200; 
call mp_mu It; 
cnvt_data = productC2D; 
if (productCID AND bit 7 <> 0) 

then cnvt data = cnvt data + 1; /* round up if necessary */ 

_d i sp I ay_pwm : 

dec_value = h_t o_d_wo r d ( c nvt data); 

di spl ay^wordCAD = 0; ”* 

di sp I ay^wo r dt3 0 = $80; 

call s h i f t_L 4 ; 

call s h i f t_L 4 ; 

if (accum = $30) 

then di spl ay__wordt23 = $80; 
else di spl ay_wo rdC23 = accum; 
call shi f t_L4; 
di sp I ay_wo rdCI D = accum; 
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call s h i f t_L4 ; 
display_word[OD = accum; 
call dispLa y_h n d L r ; 
end display soc; 


This routine calls the proper routines to retrieve the channel current 
and. voltage, multiply them and places the result to the serial output 
buffer. 


seudocode : 


ut_wa 1 1 s : 

save regs; 
call do_p_wa 1 1 s; 
if ( e r ro r_f lag = 0) 
then do; 

if ( dot_po s i t i on AND $80 <> 0) 
then call pu t c h a r ( ’ - ' ) ; 
call putcharlmsbyte of dec_value + $30); 
call shif t_L4 ; 
call put c h a r ( a c cum) ; 
call shi f t_L4 ; 
call putchar(accum) ; 
call shi f t_L4 ; 
call put c h a r ( a c c urn ) ; 
call shi f t_L4 ; 
call put c h a r ( a c c urn ) ; 
call msg_hndlr ('WATTS'); 

end; 

else call msg_h nd I r ( ' I NVA L I D CHANNEL OR DATA'); 
unsave regs ; 
end put watts; 


This routine calls the proper routines to retrieve the channel current 
and voltage, multiply them and sets up the result for the front panel 
LCD display. Notice that the maximum power that can be displayed is 
19999 watts. 


seudocode : 

ut_wa't t s : 

save regs ; 
call d o_o_w a 1 1 s ; 
if (error_flag = 0) 
then do; 

if (dec_value >= 20000) 
then do; 

error_num = $03; 
call displa y_e r r o r ; 

end; 

else do; 

do index = 3 to 0 step -1; 
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call shi f t_L4 ; 

di sp I ay__wo r dC i ndexD = accum; 

end; 

if (msbyte of dec value = 1) 

then di spl ay_wo rd[4D = dot__pos i t i on OR S40; 
else d i sp I ay_wo rdC43 = dot_po s i t i on; 
call display_hndlr(); 

end; 

end; 

else call di spl ay__huh; 
unsave regs; 
end out watts; 


This routine 
’’displayable 


does the actual retrieving, multiplying and 
watts" for out watts and put watts. 


* ★ Tk 

conversion tc 


Pseudocode: 


fin d_wa 1 1 s : 

save regs; 
sign_flag = 0; 
if (mem_byte <= 10) 
then do; 

s a ve_wa t t_c h_num = mem_byte; 

itierr!_byte = 0; /* this forces battery_V to be used f 

the calculation */ 


call fin d_v o 1 1 s ; 

mem_byte = s a ve_wa t t_c h_num ; 

end; 

else call find_volts; 
if (e r r 0 r__f lag = 0) 
then do ; 

volt_sign = d ot_po s i t i on; /* get volt sign */ 
multi = cnvt_data; 
call fin d_a m p s ; 
if (e r ror_f lag = 0) 
then do; 

dot_position = ( dot_po s i t i on XOR volt_sign) AND ! 

/* include amp sign *( 

mult2 = cnvt__data; 
call mp mult; 
divide p's = product; 

if <(mem_byte >- 31) OR (mem_byte *0)) 
then divisor = 100; 
else divisor = 1000; 
call mp_d i V ; 
cnvt_data = quotient; 
dec__value = h_t o_d_wo r d ( c nvt_da t a) 

end; 

end; 

unsave regs; 
end find watts; 
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This routine retrieves the channel number, tests to see that it is 
acceptable and calls find_watts if it is. Otherwise it sets the error_fla< 
Both find_amps and find_voLts test for channels, but there are couple othei 
channels, such as channel 38 that are not meaningful in this context. Hem 
the double-check. Notice, that although the pseudocode implies that there 
3 routines, they are actually written as one routine with 2 entry points. 


Pseudocode: 


do__p_watts: 

save regs; 
cmd_out_pt r = 1 ; 
mem_byte = getbytel); 
call _do_wa 1 1 s ; 
unsave r egs ; 
end do__p_watts; 

do_o_watts: 

save regs; 

mem_byte = get_dataC); 
call _do_watts; 
unsave regs; 
end do o watts; 


_do_watts: procedure; 
error_flag = 0; 
if (asci i__hex_f lag = 1) 
then do; 

i f ( mem_by t e < 3 6) 

then call find_watts; 
else error_flag =1; 

end; 

else error_flag =1; 
unsave regs ; 
end do watts; 


This routine routes or arranges for the routing of 6 data channels to 
the serial port. The data channels are: 
channel 00 - state of charge 
channel 36 - battery temp 
channel 37 - freezer temp 
channel 40 - corrected state of charge 
channel 41 - equalization count 
channel 42 - pwm value 


seudocode : 


u t_d a t a_c h a n n e I : 
save regs; 
cmd_out_pt r = 1 ; 
mem_byte = getbytel); 
if ( a sc i i_h ex_f I ag = 1) 
then do; 
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QOALiTy 


if (mem byte = 0) then call put_soc; 

else Tf (meni__byte = S4D) then call put_csoc; 

else if {mem__byte = S41) then call put_equal; 
else if (mem_byte = $42) then call out_pwm; 
else call dump^temp; 

end; 

else call put_huh ; 
unsave regs; 
end put data channel; 


: **ll 


; This routine locates the msbyte of s t a t e_o f_c hg , c s t a t e_o f_c hg , own va 
; or equalization count (depending on the entry point), converts it iTitc 

; percentage and returns the value in dec_value ready for shifting and c 

• 

/ 

; State_of_chg is stored: X.XXX XXXX XXXX XXXX 

/ 

; inpliedbinarypoint 


; Where this value represents (decimal pe r c en t ) / 1 DO) * 32768 

f 

; To convert back to decimal for display, we first multiply by 200 (base 
;result ingin: 


; (decimal pe r c e n t ag e / 1 00) * 32768 * 2 * 100 = (decimal percentage) * 6 

/ 

; So, by taking the msbyte of the result, rounding it up or down by look 
; at the msb of the previous byte, and converting to decimal we have a v 
; for output. Although the pseudocode shows this to be 5 separate routi 
; in the assembly code they are condensed to just one, with 4 entry poin 



Pseudocode : 


put_c soc : 

save regs ; 

msbyte of multi = msbyte of estate of chg; 
Is byte of multi = $80; 
call put_so c ( ) ; 
unsave regs; 
end csoc; 


put_soc: 

save regs; 

msbyte of multi = msbyte of state_of_chg; 
Isbyte of multi = 2nd msbyte of st at e_of_c hg ; 
call put_so c ( ) ; 
unsave regs; 
end soc ; 


put_equa I : 

save regs; 

msbyte of multi = msbyte of equal count; 
Isbyte of multi = 2nd msbyte of equa l__c ount ; 
call __d i s p I a y__s o c ( ) ; 
unsave regs; 
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end put__equal; 
jt_pwm : 

save pegs; 

msbyte of cnvt_data =0; 

Isbyte of cnvt_data = pwm_vaLue >> 2; 
call _put_pwm : 
unsave regs; 
end put pwm; 


DUt_soc: procedure; 

mu 1 12 = 200 ; 

call m p_m u L t ; 

cnvt_data = productC23; 

if (productCID AND bit 7 <> 0) 

then cnvt_data = cnvt_data + 1; /* round up if necessary ★/ 

DUt_pwm : 

dec_value = h_to_d_wo rd ( c nvt_data) ; 
call s h i f t_L4 ; 
call shi f t_L4; 

if (accum = $30) then accum = $20; 
call put c h a r ( a c cum ) ; 
call shi f t_L4 ; 
call put c h a r ( a c c urn) ; 
call shift_L4; 
call put c ha r ( a c cum) ; 
call put c ha r ( ' 5! ' ) ; 
end put soc; 


This routine locates the "raw A/D count" for a specified channel and 
converts it into decimal volts and formats the data for the serial 
port. 


5 eudocode : 

jt_vo It s : 

save regs; 
cmd_out_ptr =1; 
mem_byte = getbyteO; 
if (asci i_hex_f lag = 1) 
then do; 

j m p_v 0 1 1 s : 

call fin d_v o 1 1 s ; 
if ( e r ro r_f lag = 0) 
then do; 

dec_value = h_to_d_wo rd ( cnvt data); 
if (dec_value >= 10000) 

then call msg_h nd I r ( ' R EAD I NG OUT OF RANGE'); 
else do; 

if ( s i g n_f lag = 1 ) 
then do; 

call putcharl'-'); 
s i g n_f lag = 0 ; 

end; 
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else call putcharC* 
call shift_L4; 
call put c h a r ( a c cum) ; 
if ( dot_pos i t i on =3) 

then call putcharC* 
call s h i f t_L4 ; 
call put c ha r ( a c cum ) ; 
call s h i f t_L4 ; 
call put c ha r ( a c cum) ; 
if ( dot_po s i t i on = 1) 

then call putcharl' 
call s h i f t_L4 ; 
call put c h a r ( a c cum ) ; 
call msg_hnd I r ( ' vo It s ' ) 

end; 


end; 

else call put_h uh ; 

end; 

else call pu t_h u h ; 
unsave reg; 


end put volts; 


•); 






; This routine locates the "raw A/D count" for a specified channel and 
; converts it into decimal amps and formats the data for the serial 
; port. 


Pseudocode: 


put___amps : 

save regs; 
cmd_out_ptr =1; 
mem_byte = getbyteC); 
if ( a s c i i_h e x_f I ag = 1) 
then do; 

if {mem_byte = $40) 

then call put_total_I; 
else do ; 

dump_amp s : 

call f i nd__amps ; 
if (error_flag = 0) 
then do; 

dec_value = h_t o_d_wo r d ( c nvt^d a t a) ; 
if (dec_value >= 10000) 

then call msg_h nd I r ( ' R E AD I N6 OUT OF R 
else do; 


if (sign = 1) then call putchar ( 

call shift__L4; 

call putchar (accum) ; 

call shi f t_L4; 

call put c h a r { a c cum) ; 

if (dot_position = 2) 

then call put c ha r ( ' . ' ) ; 
call s h i f t^L4 ; 
call putchar(accum) ; 
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if (dot_pos i t i on = 1) 

then call put c h a r ( ' . ' ) ; 
call s h i f t_L4 ; 
call put c ha r ( a c cum) ; 
call msg_hnd I r( 'amps ' ) ; 

end; 

end; 

else call put_huh; 

end; 

else call put_huh ; 
unsave reg; 
end put amps; 


This routine takes the raw channel number from the command buffer and 
uses it as an offset into the dump_array and outputs the contents in 
ascii format to the serial port. 


seudocode : 

u t_r a w_c h a n n e I : 

save regs; 
cmd__out^pt r = 1 ; 
offset = getbyteO; 

if ( a s c i i_hex_f I ag = 0) then call put_huh; 
else do; 

if (offset > $37) then call put_huh; 
else do; 

if (offset = $37) then offset = $36; 

offset = d_to_h (of f set) ; 

offset = (offset*2) + 1; 

mem__byte = dump_a r r ay Co f f s et3 ; 

call putbyt e (mem_byt e) ; 

offset = offset - 1; 

mem_byte = dump_a r rayCof f set]; 

call putbyt e ( mem_byt e) ; 

end; 

end; 

c m d_o u t_p t r = 0 ; 
unsave regs; 
end put raw channel; 


This routine outputs the current time to the serial output port. It is 
called by itself and also from dump state. 


seudocode : 

ut_t i me : 

save regs; 

call msg_hnd I r ( ' TIME : ' ) ; 
call putbyte(hours) ; 
ca 1 1 putchar ( ' : ' ); 
call put by t e (m i nu t es) ; 
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call putchar('CR'); 
call putchar('LF’);^ 
end put time; 




; This routine _ col lects the "raw A/D count" for the specified channel, 

; converts it into a decimal temperature, format it and outputs it to tl 
;serialport. 


Pseudocode: 


put_t emp' 


save reos; 
cmd out__ptr 


= 1 


mem_byte = getbytel); 
if (ascii_hex flag = 1) 
then do ; 

dump_t emp : 

calif ind_ temp; 
if ( e r ro r_f lag = 0) 
then do; 

if ( d i v_b y _2 e r o = 1 ) 

then call msg__hnd I r ( ' D I VI DE BY O'); 
if ( d i v_o verflow = 1) 

then call ms g_h nd I r ( ' D I V I DE OVERFLOW); 
dec_value = h__t o_d_wo r d ( c nvt_d a t a) ; 
if (dec_value >=“10000) 

then call msg_h nd I r ( • R E AD 1 NG OUT OF RANGE') 
else do; 

if ( s i g n_f lag = 1 ) 

then call pu t c h a r ( ' - ' ) ; 
call shift L4; 


end 


end; 
else call 
unsave reg; 
put temp; 


call 
call 
call 
call 
call 
call 
call 
call 
call 

end; 

end; 

else call put_huh; 


putchar(accum); 
s h i f t_L4 ; 
putchar(accum); 
s h i f t_L 4 ; 
putchar(accum) ; 
put c ha r ('.'); 
s h i f t_L4 ; 
putchar(accum) ; 
msg hndlrC 'DEG C ) 


put_h uh ; 


This routine is where the actual 
"raw A/D count" is accomplished, 
permit display of temperature to 
are considered valid. 


look up and conversion to degrees of t 
The final value is actually 10*Ts to 
1 decimal place. Only channels 36 and i 
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Pseudocode : 

f i nd__temp : 

save pegs; 
error__flag = 0; 
sign_flag = 0; 
dot_position = 1; 

if ((mem_byte = $36) OR (mem_byte = $37)) 
then do; 

mem_byte = mem_byte - $16; 
cnvt_data = dump_a r rayCmem_byte3; 
cnvt_data = cnvt_data << 2; 

cnvt_data = cnvt_data - 2560; 

if (cnvt_data < 0) 
then do; 

cnvt_data = 2's comp (cnvt_data); 
s i g n_f Lag = 1 ; 

end; 

strobe watchdog timer; 
cnvt_data = cnvt_data * 2092; 

cnvt_data = cnvt_data / 10000; 

if (sign__flag = 1) 

then cnvt__data = 250 + cnvt_data; 
else do; 

cnvt_data = 250 - cnvt_data; 
if (cnvt_data < 0) 
then do; 

cnvt_data = 2's comp (cnvt_data); 
sign_fLag =1; 

end; 

else s i g n_f Lag = 0 ; 

end; 

end; 

eLse error_fLag =1; 
end find temp; 


This routine sets the Time of Day counters to a new vaLue (i.e. sets the 
cLock). User input is checked for two types of errors: 1) if an entry 
is not between 0 and 9; and 2) if the hours vaLue > 23 or the minutes 
vaLue > 59. If error type 1 is encountered, an Er04 is signaLLed to 
the LCD or the message "Bad digit vaLue for set_tim\n" is sent to the 
terminaL. If error type 2 is encountered, an Er05 is signaLLed to the 
LCD dispLay or the message "InvaLid hours/minutes vaLue" is sent to the 
terminaL. This routine has two entry points. Which one is used depends 
upon which input device generated the command, terminaL keyboard, or 
front paneL keypad. ALthough the pseudocode indicates 3 routines, the 
assembLy code is actuaLLy 1 routine with 2 entry points. 


eudocode : 

t_t im_term : 

cf Lag = 0; 
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__set__t 1 ml { ) ; 
end set__Tim^term; 

s e t__t i m__k ybd : 

cf I ag = 1 ; 

_set_t imi ( ) ; 

end s et_t i m_kybd; 

__set__t imi : 

save regs : ; 
i = 1 + cflag; 
minutes = 0; 
hours = 0; 

k = (hours << 8) OR minutes; 
do j = 3 to 0 step -1; 

i f ( ( command_bu-f f erCi D < $30) OR ( c omman d_but t e r C i D > $39)) 
then do; 

if (cflag = 1) 

then call dispLa y_e rror(#$04) ; 
else call msg_h nd I r ( ' D I GI T OUT OF RANGE'); 
goto set_t ime_done; 

end; 

else do; 

k = k << 4 ; 

k = k OR ( c omma nd_buf f e r C i 0 - #$30); 
i = i + 1 ; 

end; 

end; 

minutes = k AND #$FF; 
hours = (k >> 8) AND #$FF; 
if ((hours > 23) OR (minutes > 59)) 
then do ; 

if (cflag == 1) 

then call d i s p I ay_e r r o r ( # $0 5 ) ; 

else call msg_h nd I r ( ' I NVA L I D HOURS/MINUTES VALUE'); 

end; 

else do; 

timer_csr = #$C3; 
timer_csr = #$09; 
time r_d ata = #$00; 
time r_d ate = #$00; 
timer_csr = #$0A; 
time r__d ata = #$00; 
timer~data = #$00; 
time r_c s r * #$43 ; 
timer_csr = #$0A; 
time r_d ata = minutes; 
time r__d ata = hours; 
timer_csr = #$0F; 

if ((minutes >= #$00) AND (minutes < #$30)) 
then do; 

timer__data := #$30; 
time r__d ata = hours; 

end; 

else do; 

timer data = #$00; 
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t1mer_data = hours + 1; 

end; 

timer_csr = #$43; 
timer_csr = #$0A; 
time r_d ata = #$00; 
time r_d ata = #$00; 
timer_csr = #$23; 

end; 

set_t i me_done : 
unsave regs; 
end set t imi ; 


This routine which can be called from both the front panel keypad and the 
serial port, sets the load shed threshold of the indicated load to the 
level specified. 


seudocode : 

et_^l oad_s hed : 

save regs; 

mem_byte = c omma nd_bu f f e r Cl 3 ; 
load_num = a_t o_h ( m em_by t e) ; 

if (doad__num <> $FF) AND (load_num <= 5) AND (load_num <> 0) > 
then do; 

cmd_out_pt r = 2; 

prcnt = f i nd__pe r cent ( ) ; 

if(accumO$FF) 

then s h e d_t h r e s h C I oad_n um~1 3 = msbyte of prcnt; 

else call put_huh ; 

end; 

else if ( kybd_cmd_f I ag = 1) 
then call display_huh; 
else call put_h u h ; 
unsave regs ; 
end set load shed; 


This routine which can be called from both the front panel keypad and the 
serial port, sets the load restoration threshold of the indicated load to 
the level specified. 


seudocode : 

5t_load_restor: 

save regs; 

mem byte = c ommand_buf f e r Cl 3 ; 
loa'3_num = a_t o_h ( mem_by t e) ; 

if (doad_num <> $FF) AND doad_num <= 5) AND doad_num <> 0) ) 
then do; 

cmd_out_ptr =2; 
prcnt = f i nd_pe r c ent ( ) ; 
if (accum <> $FF) 

then restor_threshC load_num-1 3 = msbyte of prcnt; 
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else call p u t__h u h ; 

end; 

else if ( kybd_cmd_f Lag = 1) 
then call displa y_h u h ; 
else call put_huh; 
unsave regs; 
end set Load restor; 



; This routine which can be called from both the front panel keypad and th 
; serial port, sets the initial battery state of charge to the Level spec 



Pseudocode : 


set_i ni t_so c : 

save regs; 
c m d_ou t_p t r = 1 ; 
prcnt = f i nd_pe r c ent ( ) ; 
if (accum <> $FF) 
then do; 

2 rrsbyte's of state_of_chg = prcnt; 

3 Lsbyte's of state_of_chg = 0; 

end; 

else if ( kybd_cmd_f t ag = 1) 
then call displa y_h u h ; 
else call put_h uh; 

unsave regs; 


This routine is used by the pervious 3 routines to convert the 3 charad 
in the cotnmand buffer starting with the position pointed to by cmd_in_p1 
into the fraction corresponding to the percentage of state of charge. 
This value is returned in percent. For example. 


100 percent results in a value of XI 000 0000 0000 0000 

75 percent results in a value of X0110 0000 0000 0000 

50 percent results in a value of X0100 0000 0000 0000 

25 percent results in a value of X0010 0000 0000 0000 

1 percent results in a value of XOOOO 0001 0100 0111 


; If the 3 characters represent a value over 100% or contain digits over 
; 9, SFF is returned in the accumulator. 



Pseudocode : 


fin d^p e r c e n t : 

save regs; 
temp = cmd_out_ptr; 
cmd_out_ptr = cmd_out^ptr +1; 
mem_byte = getbytel); 
if ( a s c i i_hex_f L ag = 1) 
then do; ~ 

mem byte = d to hCmem byte); 
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mem 

if 


_byte = mem_byte * 2; 

(ove r_1 0_f L ag' = 0) 
then do; 

if ((mem_byte = 0) AND ( c omma nd_buf f e r C t empD 
then prcnt = pe r c ent_t b I C$ C8D ; 
else if ((me m_b yte <> 0) AND 

(command bufferCtempD 
then prcnt = percen t_t bT C m e m_b y t e 3 ; 
else accumulator = $FF; 

end; 

else accumulator = $FF; 




''S 


POOR QUALITY 


end; 

else accumulator = $FF 
unsave regs; 


end find percent; 


= $ 31 )) 

= #30): 


PERCENT TABLES FOR FIND PERCENT 


>e r cent tb I : 


.word 

$0000, 

$0147, 

$028F, 

$03D7, 

$051E, 

$0666, 

$07AE, 

$08F5 

.word 

$0A3D, 

$0B85, 

$0CCC, 

$0E1 4, 

$0F5C, 

$10A3, 

$1 1EB, 

$1333 

.word 

$147A, 

$1 5C2, 

$1 70A, 

$1 851 , 

$1999, 

$1 AE1 , 

$1 C28, 

$1 D70 

.word 

$1 EB8, 

$2000, 

$2147, 

$228F, 

$23D7, 

$251E, 

$2666, 

$27AE 

.word 

$28F5, 

$2A3D, 

$2B85, 

$2CCC, 

$2E14, 

$2F5C, 

$30A3, 

$31EB 

.word 

$3333, 

$347A, 

$35C2, 

$370A, 

$3851, 

$3999, 

$3AE1 , 

$3C28 

.word 

$3D70, 

$3EB8, 

$4000, 

$4147, 

$428F, 

$43D7, 

$451E, 

$4666 

.word 

$47AE, 

$48F5, 

$4A3D, 

$4B85, 

$4CCC, 

$4E1 4, 

$4F5C, 

$50A3 

.word 

$51EB, 

$5333, 

$547A, 

$55C2, 

$570A, 

$5851, 

$5999, 

$5AE1 

.word 

$5C28, 

$5D70, 

$5EB8, 

$6000, 

$6147, 

$628F, 

$63D7, 

$651E 

.word 

$6666, 

$67AE, 

$68F5, 

$6A3D, 

$6B85, 

$6C CC, 

$6E1 4, 

$6F5C 

.word 

$70A3, 

$71 EB, 

$7333, 

$747A, 

$75C2, 

$770A, 

$7851, 

$7999 

.word 

$7AE1 , 

$7C28, 

$7D70, 

$7EB8, 

$8000 






This routine, called every 100 msec, by the 
absolute values of battery_V and total_chgr 
tracking routine as well as several others. 


r u n_t a s k_m aster, 
I for use by the 


provides the 
max power 


•seudocode: 

jbs__cnvt: 

save regs; 
if (battery_V < 0) 

then ab s_ba t t e r y_V = -battery_V; 
else abs__battery V = battery_V; 
if (tota l_chg r_I < OT 

then abs_t ot a l_c hg r_I = - 1 ot a l_c hg r_I ; 
else abs_t ot a l_c hg r_I = t ot a l_c hg r_I ; 
unsave regs; 
end abs cnvt; 


This routine is called to dump the current total charger current as part 
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; of the dump^state routine. The put_totaL_I entry point is used by ou 
; data channel and put data channel. 



Pseudocode : 


dump_tota l_I : 

save regs; 

call msg_hnd I r ( 'TOT CH6R I ='); 
put_t ot a l__I : 

cnvt_data = a b s_t ot a l_^c hg r__I ; 
dec__value = bf_d i v1 0 ( c nvt_dat a) ; 
if ( t ot a L_c hg r_I < 0) 

then call put_c h a r ( ' - ' ) ; 
call shi f t_L4 ; 
call putchar(accum); 
call s h i f t_L4 ; 
call put c h a r ( a c c um) ; 
call s h i f t_L4 ; 
call put c ha r ( a c cum) ; 
call putcharl'.') 
call s h i f t_L4 ; 
call pu t c h a r ( a c c um ) ; 
call msg_hnd I r ( ' amps ' ) ; 
unsave reg; 
end dump total I; 



; This routine does a BRUTE FORCE divide by 10 (base 10) of the number i 
; cnvt_data and returns the quotient in dec_value because due to this cl 
; algorithm, it is also converted into decimal at the same timeC!). All 
; of this is necessary to convert the current in the form xx.xx to Oxx.x 



Pseudocode: 


bf_d i v1 0 : 

save regs; 
dec_value = 0; 

do while (cnvt_data > 1000 ); 1000 (baselO) 

cnvt__data = cnvt_data - $3E8; 1000 (base16) 

dec__value = dec_value + 100; 

end; 


do 

while ( c nvt_dat a 

> 100 

) 

• 

100 

(basel 0) 


cnvt__data = cnvt 

__dat a 

- 

$64; 

100 

(b a s el 6) 


dec__value = dec 

value 

+ 

10; 



end 

/ 






do 

while ( cnvt__dat a 

> 10 ) 

r 


10 

(base TO) 


cnvt__data = cnvt 

__dat a 

- 

$A; 

10 

(basel 6) 


de c__va 1 ue = dec 

V a 1 u e 

+ 

1; 




end; 

unsave regs; 
end bf div 10; 
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xxxxxx 
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; This routine, called at system reset, and from the serial port for te 
; will turn on all segments of the LCD display, all warning LED indicat 
; and the warning buz 2 er for a period of (about) 1 second. After the t 
; delay, the routine will return the LCD display, warning buzzer, and 
; indicator LEDs to their original state before this routine was called 


Pseudocode: 


I amp_t e s t : 

save regs:; 

if ( (comput e_f I ags AND #run_flag) <> 0) 
then do; 

digitsCAD = Ads py_syn c_c t r I OR #$DF; 

digits C3D=#SFF; 

digits C23 = A$FF; 

digitsMD = A$FF; 

digitsCOD = A$FF; 

call displa y_d igitsC); 

I ed_ou t_l a t c h = stow_leds OR #leds_on; 
disable interrupts; 

kybd wr_port = " ( c o lumn_n umbe r AND A$0F) OR #bell_on; 
enabTe interrupts; 

do i = 2 to 0 step -1; /* waste " 1 second */ 

do 3 = 255 to 0 step -1; 

do 3 * = 255 to 0 step -1; 
end; 

end; 

end; 

I ed_out_l at c h = stow_leds; 
disable interrupts; 
i f ( a I a r m_ flags < 0 ) 

then kybd_wr_port = “ ( c o I umn_num b e r AND A$0F) OR Ab< 
else kybd wr_port = “ (co lumn_numbe r AND A$0F); 
enable interrupts; 
call d i s p I ay_h nd I r ( ) ; 

end; 

unsave regs; 
end lamp test; 


; This routine performs the "MULTIMETER FUNCTION". Five of the front pe 
; display functions operate continuously like a multimeter. Each time t 
; routine is called, which is once every 100 msec , it reactivates the c 
; function whose starting address is stored in mu 1 1 i m e t e r_add r . If 
; multimeter flag is zero, this routine is skirted. 


Pseudocode: 
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multiineter_func : 

save regs; 

if (mu L t ime t e r_f I ag = 1) 
then do; 

call d i s p I ay_f un c t i on 3 multimeter addr; 
end; ~ 

unsave regs; 
end multimeter func; 


/ 


/ 

/ 


/ 


This routine "opens" memory at the indicated address and sends the 
contents to the serial port. Successive CR*s cause the next location 
be read, while characters will back up to the previous location. 

Any location can be changed by entering the new data and hitting eitht 
a CR or a . The CR will take you forward, while the will take 

backwards. 


Pseudocode : 


open 


mem : 


save regs ; 
cmd_out_pt r = 1 ; 

msbyte of mem addr = getbytel); 
if ( a s c i i__h ex_f L ag = 0) 
then put___huh ; 
else do ; 

Isbyte of mem__addr = getbyteC); 
if ( a s c i i__h ex”f I ag = 6) 
then put_huh ; 
else do ; 

call _s how_mem; 

do while ( c nt r l_z_f I ag = 0); 

do while (serial_cmd flag = 0) 
strobe watchdog tTmer; 
end; 

serial_cmd flag = D; 
mem_byte = getbyteC); 

if ( Case i i_hex_f lag = 0) AND ( c omma n d__b u f f e r CO 3 <> 
then do; 

call put_huh ; 
c m d_o u t__p t r = 0 ; 
command_buf f e r COO = 0; 
end; 

else do; 

if (command_buf ferCOO <>0) 

then mem C m em_a d d r 3 = mem byte; 
if ( L ook__bk wa r d = 1) 
then do; 

look_bkward = 0; 
deer mem addr; 
call __show_mem; 
call msg__hnd I r ( ' CRLF ’ ) ; 
end; 

else do; 

incr mem addr; 
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call _show_mem; 
end; 

end; 

end; 

end; 

end; 

cntrl_ 2 _flag = 0; 
unsave regs; 
end open_mem; 

s how_mem : 

call putby t e ( mem_add r+1 ) ; 
call putbyteCmem addr); 
calLputcharl' 'T; 
mem_byte = memCmem_addrD ; 
call putbyt e (mem_byte) ; 
cmd_out_ptr = 0; 
end show mem; 


This routine is called from the 4 MSec interrupt handler to control keyboai 
scanning. If no key is pressed, reset the debounce counter and skip to thi 
next keyboard column. If a key is pressed, decrement the debounce counter, 
and if we've reached zero, interpret the key. After the key has been 
interpreted, parse it: if it's a NAK (Control-U) clear the cmd_in_ptr; 
if it's a NULL (EOF), null terminate the command buffer and set the 
kybd_cmd_f L ag bit; otherwise just shove the character in the command buffei 
update the cmd_in_ptr (adjust it for overflow if necessary) and continue 
sc anni ng . 


’seudocode : 

; c a n_kybd : 

save regs; 

row_number = ( “ k yb d_r d_po r t ) AND SFO; 
if (row_number = 0) 

then call no_key_p r e s s ed; 
bounce_count = bounce_count -1; 
if (bounce_count <= 0) 
then do; 

if ((i_o_flags2 AND #key_pa r sed_f I ag) = 0) 
then do; 

i_o_flags2 = i_o_flags2 OR #key_pa rsed_f I ag; 
j = key_i nt r p ( r ow_numbe r) ; 
if (j < 0) 
then do; 

if (j = $81) 

then CO lumn_numbe r = $01; 
call no_key_p r essed( ) ; 

end; 

else if (j = 0) 
then do; 

command_buf f er Ccmd_i n_pt rU = j; 
c md_i n_pt r = j ; 

i_o_flags = i_o_flags OR #kybd cmd flag; 
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'end; 

else if (j = $15) 

then cmd_in_ptr =0; 
e Lse do; 

command_buf f erCcmd_i n_pt rU = j; 
cmd_in_ptr = cmd_in_ptr +1; 

" if (cmd_in_ptr = $20) 

then do; 

call dispLa y_h u h ; 
cmd_in_ptr = 0; 

end; 

end; 

end; 

end; 

unsave regs; 
end scan_kybd; 

no_key_pressed: 

i_o_flags2 = i_o_fLags AND " #k ey_pa r s ed_f L ag ; 
bounce_count = ma x_boun c e_c oun t ; 

CO Lumn_number >> 1; 
if (coLumn_number = 0) 

then CO Lumn_numbe r = $08; 
if (aLarm_flags < 0) 
then do; 

kybd_wr_port = ( (”column_number) OR ($20 AND write_port_ 

OR #be L l-_on; 

write_portb = ( (’■coLumn_number) OR ($20 & w r i t e_po r t_b ) ) 

OR #be I L_on; 

end; 

else do; 

kybd_wr_port = ( (~co Lumn_number) OR ($20 8 w r i t e_po rt_b) 
write_portb = ( (“co Lumn_number) OR ($20 8 wr i t e_po rt_b) ) 
unsave regs; 
end no key pressed; 


; The following routine is called with a (hopefully) non-zero value in t 
; accumulator which represents the sensed keyboard row mask (in bits <7- 
; This row number and the corresponding column number are mapped into ar 
; index into an array of ASCII values. The appropriate ASCII value for 
; the key pressed is returned in the accumulator. If a zero row mask wa 
; provide to this routine, $80 is returned. If the column number was ol 
; of Its allowable range $81 is returned. If more than one key is press 
; (row mask has more than one bit set), the "first key" (first bit set) 

; is the one that is mapped to an ASCII value. The key is mapped to 

; the'ASCII value $00 so that it can easily be recogni zed- as the EOF 
; character. 

; If the mapped ASCII value is a number (0-9) then the front panel displ 
; is updated by scrolling the new digit in from the right (least signifi 
; digit). If the key was pressed indicating an operator entry error 

; we get real fancy and clear the display. 
************************************************************************* 

Pseudocode; 
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ey_intrp: 

save pegs; 

if ((j = row_mapLva Lue >> 43) >= 0); /* j = $80 */ 

then do; 

j = j + c o L_map[! c o L umn_numbe r3 ; 

if ((j = keyb rd_mapC j 3 ) > 0); /* j = $81 or j = 0*/ 

then do; 

if (j = $15) 
then do; 

do i = 3 to 0 step -1; 

di spl ay_wo rdC i 3 = #$80; 
d i spl ay_wo rdr43 = 0; 
call d i sp I ay_hnd L r; 

end; 

else if (cmd_in_ptr = 0) 
then do; 

do i = 2 to 0 step -1; 

di sp L ay_wo rdC i 3 = #$80; 
mu 1 1 i m e t e r_f L ag = 0; 

end; 

k = keyb rd_h ex C y3 ; 
do i = 3 to 0 step -1; 

d i s p L ay_wo rdC i 3 = d i spl ay_wo rdC i -1 3 ; 
d i sp I ay_wo rdC 03 = k; 
d i sp L ay_wo rdC43 = 0; 
call d i s p I ay_h nd I r ; 

end; 

end; 


end ; 


end; 

unsave regs; 


end key intrp; 


KEY INTRP TABLES 


The following array provides the mapping for converting the sensed keyboard 
row number into the next level array index. This array also performs the 
function of finding the "first set bit" (in case multiple keys are pressed) 
and returns an error value ($80) for no key pressed at all. 


0 w__m a p : 

.byte $80, $03, $02, $02 
.byte $01 ,$01 ,$01 ,$01 
.byte $00, $00, $00, $00 
.byte $00, $00, $00, $00 

The following array provides the mapping for converting the "column scanned 
mask into an array index that can be added to the index from the row_map 
in order to find out which one key has been pressed. For index values 
into this array that have none or more than one bit set, a "next-level" 
index is returned that will map into an invalid ASCII key value (i.e. 
the key will be $81 ) . 
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c o L_m a p : 

.byte $1 0,$0C ,$08,$1 0 
•byte $04,$1 0,$1 0,$1 0 
•byte $00^$1 0,$1 0,$1 0 
.byte $1 0^$1 0^$1 0^$1 0 

/ 

; Thrs array is the one that actually produces an ASCII value correspon< 
; to the key pressed. It also produces error indications for malformed 


; column scan 

values. 




/ 

keybrd map: 

.byte 

$44, $43, $42, $41 

7 


,"B","A" 

.byte 

$00, $39, $36, $33 

7 

■1 ^ fl II ^ M 

,"6","3" 

.byte 

$30, $38, $35, $32 

7 

"0","8" 

II C II II ^ II 

^ J ^ C 

.byte 

$1 5, $37, $34, $31 

7 

"*","7" 

It /II II 4 II 

, H , 1 

.byte 

• 

$81 ,$81 ,$81 ,$81 

7 

Column 

scan error return 


; This array is analagous to the one above except that it contains hexac 
; values of the keys pressed to speed up the display update function. J 
; having to convert ASCII back to HEX. 

/ 

keyb rd_hex : 

.byte $0D,$0C,$0B,$0A 
.byte $00^$09,$06,$03 
.byte $00, $08, $05, $02 
.byte $00, $07, $04, $01 


This routine tests for rcve and xmit interrupt condx from the serial i 
port, services all valid ones and aborts if none exist. This routine 
not a true subroutine, in that, it lies "in-line" as part of the over; 
IRQ service routine which also includes break. 

It supports such user amenities as: 

1. “H, del, backspace - delete last character 

2. “U - "flush" command_buf f e r 

3. adds a LF whenever a CR is received 

4. “Z - return to cmd_intrp 

5. "-" - used to "backup" when using the open memory 

command in the monitor 

Upon' receipt of a CR, a LF is sent out, and the s e r i a l_imd_f I ag is set 
All spaces are deleted as they are input. 

The command buffer is assumed to be 32 bytes long and linear, i.e. the 
pointers must be zeroed when the data has been used by the called func 


Pseudocode : 
serial port: 


11-60 



Feb 17 12:17 1984 /u / t am / so L a r/ PS EUDOCODE Page 40 


save pegs; 

uart_status = pia_portb; 
if (uart_status AND bit 7 <> 0) 
then do; 

cntrL_z_fLag = 0; 
char = uart; 
i f (char < $20) 
then do; 

if (char = $08 OR char = $7F) 
then do; 

call msg_h nd L r ( ' " H “H'); 
cmd_in_ptr = cmd_in_ptr - 1; 

end; 

else if (char = $0A OR char = SOD) 
then do; 

call putchar('CR'); 

call putchar('LF'); 

c omma nd_bu f f e r C cmd in ptrD = 0; 

c m d i n_p t r = 0 ; 

serTa l_cmd_f I ag = 1; 

end; 

else do; 

call putchar('“'); 

char = char + $40 ; make it printable 

call put c ha r { c h a r ) ; 
if (char = $15) 
then do; 

cmd_i n_pt r = 0; 
call putchar('CR'); 
call putchar('LF'); 
call putchar('*'); 

end; 

if (char = $1A) 
then do; 

cnt r l_ 2 _f lag = 1 ; 
call putchar('CR'); 
call putchar('LF'); 

end; 

end; 

end; 

else do; 

call put c h a r ( c ha r) ; /* echo the character */ 

command_buf f erCcmd_i n_pt r3 = char; 
cmd_in_ptr = cmd_in_ptr +1; 
if ( mu 1 1 i m e t e r_f I ag = 1) 

then mu 1 1 i me t e r_add r = Sd i sp I ay_d ef a ul t - 1; 
if (char = $2D) then look_bkward =1; 

end; 

end; 

if (uart_status AND bit 6 <> 0) 
then do; 

if (byte_count <> 0) 
then do; 

usrt = outpu t_b ufferCpu t_o u 1 3 
put__out = put_out + 1; 
deer byte count; 
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end; 

else disable xmit ints; 

end; 

unsave pegs; 
end seriaL_port; 

; This routine services the BREAK instruction trap and the IRQ interrup 
; It determines which of the two it was that vectored the CPU to this 
; routine. If it was a breakpoint, it continues, if an IRQ occurred in 
; control is passed to serial port for servicing. 


Pseudocode : 


break: 

if (B_flag <> 1) then go to serial_port; 
else do ; 

x_reg_stor = contents of X reg; 
accum_stor = contents of accumulator; 
flags_stor = psw popped off stack; 
y_reg_stor = contents of Y reg; 
pop "useless" PC off stack; 
pc_stor = brkpt_addr; 

sp stor = contents of the stack pointer; 

call msg_hndlr ('PC = '); 

call putbyte (msbyte of pc_stor) ; 

call putbyte (Isbyte of pc_stor); 

call msg_hndlr (' A = 

call putbyte ( a c cum_s t or ) ; 

call msg_hndlr (' Y = '); 

call putbyte ( y_r eg_s to r ) ; 

call msg_hndlr (' X = '); 

call putbyte (x_reg_stor) ; 

call msg_hndlr (' SP = 

call putbyte (sp_stor); 

call msg hndlr (' P = '); 

call putFyte ( f I ags_sto r) ; 

call msg_hndlr ('CRLF'); 

call rem_b rkpt ; 

enable interrupts; 

go to run_task_master; 

end; 

e-nd break; 


;********************************************************************** 
; Thi^ routine begins execution at the current user PC lo-cation or at t 
; location specified in the command buffer, if any. A, X, Y, P, and S 
; always loaded from their respective storage locations. 


Pseudocode: 
go : 

cmd_out_ptr =1; 
if (command bufferCID <> 0) 
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t h en do; 

msbyte of pc_stor = getbyteO; 
if ( a s c i i_h ex_f L ag =0) 
then do; 

c m d_o u t_p t r = 0 ; 
call put_huh; 
go to end go; 
end; 

Isbyte of pc_stor = getbyte(); 
if ( a sc i i_h ex_f L ag = 0) 
then do; 

cmd_out_ptr = 0; 
call put_h uh ; 
go to end go; 
end; 

end; 

unsave 8 addresses and regs saved by cmd_intrp; 

cmd_out_ptr = 0; 

stack pointer = sp_stor; 

X reg = x_reg_stor; 

Y reg = y_reg_stor; 
accumulator = msbyte of pc_stor; 
push accumulator; 

accumulator = Isbyte of pc_stor; 
push accumulator; 
accumulator = flags_stor; 
push accumulator; 
accumulator = accum_stor; 
r t i 

end go; 


This function places a "BRK" opcode ($00) at the address specified in the 
command buffer. Only one breakpoint is supported. The replaced opcode is 
stored in rep opcode. The breakpoint address is stored in brkpt addr. 


Pseudocode : 

;et_brkpt : 

save regs; 
cmd_out_pt r = 1 ; 

msbyte of brkpt_addr = getbyteO; 
if ( a s c i i_h ex_f I ag = 0) 
then call put_huh; 
else do; 

Isbyte of brkpt_addr = getbyteC); 
if (asci i_hex_f lag = 0) 
then call put_huh ; 
else do; 

r e p_o pcode = mernCbrkp t_a d d r D ; 
memCb rkpt_add rD =0; 
end; 

end; 

unsave reg; 
end set brkpt; 
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; This routine returns the opcode that was replaced with the "BRK". It 
; be called by the user and also the break subroutine. 



Pseud^bcode : 


rem_b r kpt : 

save regs; 

mem Cb r k pt_a dd r^ = rep_opcode; 
unsave regs; 
end rem brkpt: 


; This routine set the dump_s t a t e_f I ag to initiate dump_state from the 
; serial port or the front panel keypad. 


Pseudocode : 


s et_up_dump_k ybd : 
set_u p_dump : 

save regs; 

dump_state_f I ag = 1; 
unsave regs; 
end set up dump; 


; This routine, called from the front panel keypad, clears the valid_pas 
; flag. 


Pseudocode : 


ki I l_password: 

save regs; 
va I i d_pa s s wo r d = 0; 
unsave regs ; 
end k i I l_pa s swo rd; 

************************************************************************ 
; This routine is called via the serial port and the hex keypad and "tog 
; the-state of the run_bit so that the system alternates between RUN and 
; TEST/CALIBRATE modes. 

;*********************************************************************** 

Pseudocode: 

toggle_run_bi t : 

save regs; 

compute_f I ags = compute_f lags XOR run_flag; 
unsave regs; 
end t ogg I e_r un_b i t ; 

************************************************************************ 
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This routine is called whenever the dump_s t at e_f I ag is set to dump out the 
"state of the machine" to the serial port. The output is composed of the 
contents of the dump_array with each element converted into the appropriatt 
units. The format for the output is as follows: 


f 

TIME 

' • 

• 0 

h h : mm 






/ 

EOO 

= 

X XX . X 

VOLTS 

100 

= 

XXX. X 

AMPS 

f 

EDI 

S 

X X . X X 

AMPS 

101 

= 

X X . X X 

AMPS 

f 

E02 

=: 

X X . X X 

AMPS 

102 

= 

X X . X X 

AMPS 

f 

E03 

= 

X X . X X 

AMPS 

103 

= 

X X . X X 

AMPS 

r 

E04 

= 

X X . X X 

AMPS 

104 


X X . X X 

AMPS 

r 

EOS 

=: 

X X . X X 

AMPS 

11 5 

= 

X X . X X 

AMPS 

* 

E06 

=: 

X X X . X 

VOLTS 

106 

= 

X XX . X 

VOLTS 

r 

E07 


X X X . X 

VOLTS 

107 

= 

X X X . X 

VOLTS 

r 

EOS 

= 

X X X . X 

VOLTS 

108 

= 

X XX . X 

VOLTS 

* 

E09 

= 

X X X . X 

VOLTS 

109 

= 

X X X . X 

VOLTS 


E10 

= 

X X X . X 

VOLTS 

11 0 


X XX . X 

VOLTS 

: 

E31 

= 

X X X . X 

VOLTS 

131 

= 

XXX. X 

VOLTS 

; 

E3 2 

= 

X X X . X 

VOLTS 

132 

= 

X X X . X 

VOLTS 

: 

E33 

= 

X X X . X 

VOLTS 

133 

= 

X X X . X 

AMPS 

1 

E34 


X X X . X 

AMPS 

134 

= 

X X X . X 

AMPS 


E35 

= 

X X X . X 

AMPS 

135 

= 

XXX . X 

AMPS 


D36 

= 

X XX . X 

DEG C 

D37 

= 

XXX . X 

DEG C 


E38 


X . X X X 

VOLTS 

E3 9 


X . X X X 

VOLTS 


DOO 

= 

X X x% 

D40 = xxx% D41 

= 

X xxX 

D42 = 


SI-1 

S2-0 


L1- 

1 i 

L2-0 L3 

-1 L4 


A1 -1 

A2-1 A3 

-1 A4-1 

A5-1 A6 

-1 

Bl-1 B2-1 b: 


TOT 

CH6R I 

= X X x . X 

AMPS 


NOTE 

:: 1=0 

Each 

line 

i s 

fo rmated and 

placed 

into the 

se r i a 


output buffer. The 
routine is called again when the buffer is empty. When all of the data 
has been transmitted, the dump__s t a t e_f I ag and va I i d_pa s s wo r d are both 
cleared. In addition, the address of the proper display default routine 
is loaded into multi mete r_a ddr, the channel data (in ascii), if needed, 
is loaded into mu 1 1 i me t e r_d a t a and finally, the mu 1 1 i m e t e r_f I ag is set. 
Every one second after this, the indicated display routine is re-initiated. 


seudocode : 

ump_s t a t e : 

save regs; 

if ( cnt r l_ 2 _f I ag = 1) then goto _c nt r l_z_c r a s h ; 
if ( dump_c h anne I = 0) then call put_time; 
dump_count = 0; 

do while ( (dump^count <= 1) AND (dump_c hanne I < so c_c h anne l_num ) ) ; 
accum = I abe L_l i St Cdump_c hanne 13 ; 
call putchar (accum) ; 

mem_byte = u se r_c h_t ab I e Cdump_c ha nne 13 ; 
call putby t e (mem_by t e) ; 
call msg_hndlr(' = '); 

conv_dump_add r = conv_dump_t ab I e Cdump_c hanne 1*23 ; 
call convert_and_output routine; 
dump_channel = dump_channel +1; 

end; 

if (dump channel = soc channel num) 
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t h en do; 

call dump_so c ; 
call dump_sw_states; 
call dump_arrays; 
call dump_tota l_I; 

caLL msg_hndLr(' NOTE: 1=0N, 0=0FF'); 

_^c n t r L_2_c rash: 

dump_channeL = 0; 
dump_state_f L ag = 0; 
va L i d_pas swo rd = 0; 
mu L t i me t e r_f L ag =1; 

mu L 1 1 mete r_add r = 8d i sp L ay_def a u L t - 1; 
call put char( 'CR'); 
call putcharC'LF*); 
call putcharC'*'); 

end; 

else do; 

call putchar('CR'); 
call putchar('LF'); 

end; 

unsave pegs; 
end dump state; 



DUMP STATE LOOKUP TABLES 



label_list: .ascii " E I E I El E I El El E I El E I El E I E I El E I E I E I DD E E" 

user ch table: 


byte 

$00, 

$00, 

$01, 

$01, 

$02, 

$02, 

$03, 

$03, 

$04, 

$04, 

$05, 

3 

byte 

$06, 

$06, 

$07, 

$07, 

$08, 

$08, 

$09, 

$09, 

$1 0, 

$1 0, 

$31, 

3 

byte 

$32, 

$32, 

$33, 

$33, 

$34, 

$34, 

$35, 

$35, 

$36, 

$37, 

$3 8, 

3 


c onv_dump_t ab I e : 

NOTE: The -1 in each of the following is due to a peculiarity o1 
6502. Namely that the address stored on the stack during a jsr 
1 LESS THAN the return address. So in order to use the stack ar 
RTS to impliment an indirect JSR, the address stored in the tabi 
must conform to this rather "arbitrary" condition. 


.word 

dump_vo It s 

- 

.word 

dump_amps - 

1 

.word 

d u m p_v 0 1 1 s 

- 

.word 

dump_amps - 

1 

.word 

dump_vo Its 

- 

. word 

dump_amps - 

1 

.word 

d u m p_v 0 1 1 s 

- 

.word 

dump_amps - 

1 

.word 

dump_vo 1 1 s 

- 

.word 

dump_amps - 

1 

.word 

dump_vo It s 

- 

.word 

dump_amps - 

1 

.word 

dump_volts 

- 

.word 

dump_amps - 

1 
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.word dump_voLts - 1 

.word dump_amps - 1 

.word dump_volts - 1 

.word dump_amps - 1 

.word dump__voLts - 1 

.word dump_amps - 1 

.word dump_volts - 1 

.word dump_amps - 1 

.word dump_volts - 1 

.word dump_amps - 1 

.word dump_voLts - 1 

.word dump_amps - 1 

.word dump_voLts - 1 

.word dump_amps - 1 

.word dump_voLts - 1 

.word dump_amps - 1 

.word dump_volts - 1 

.word dump_amps - 1 

.word dump_temp - 1 

.word dump_temp - 1 

.word dump_volts - 1 

.word dump volts - 1 


This routine fill s specified region in RAM with a specified byte of data 
The starting address, the ending address and the datum are contained in the 


command buffer. 


WATCH USING THIS ROUTINE BELOW LOCATION $320, THE RESULTS MAY BE 
UNDESIREABLE BECAUSE IT MAY OVERWRITE ZERO PAGE, THE STACK OR THE 
I/O BUFFERS. 


Pseudocode : 


saveregs; 
cmd_out_ptr =1; 

msbyte of start addr = getbyteO; 
if ( a s c i i_h ex_fTag = 0) then call put_huh; 
else do; 

Isbyte of start_addr = getbyteC); 
if ( a s c i i_h ex_f I ag = 0) then call put_huh; 
else do ; 

msbyte of endin g_a ddr = getbyteO; 
if ( asc i i_hex_f I ag = 0) then call put_huh; 
else do; 

Isbyte of endin g_a ddr = getbyteO; 
if (asc i i_hex_f lag = 0) then call put_huh; 
e Ise do; 

mem_byte = getbyteC); 

if (asci i_hex_f lag = 0) then call put_huh; 
else do; 

if (endin g_a ddr - star t__a ddr < 0 ) 
then call put huh; 
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else do; 

do while (ending_addr - start_addr >= 0) 
mem C st a rt_add r3 = mem_byte; 
incr star t_a d d r ; 
end; 
end; 

end; 

end; 

end; 

end; 

end; 

cmd_out_ptr = 0; 
unsave pegs; 
end fill; 


; This routine handles the storage function of data which is downloaded 
; another computer via a serial link. The selected download format is 1 
; used with the DATA I/O PROM Programmer, i.e.: 


B$A<address>, XX XX XX XX XX. 


C S<c he c k sum> , 


where 1. XX = ascii encoded hex digits 

2. address and checksum are represented ir 
hex digits 

3. the acceptable delimiters are space, Cf 
LF. 


; In order to maintain as much universality as possible, it is desireabi 
; make the routine independent of interrupt service routines which may i 
; buffers of undefined form. Hence, IRQ's are disabled for the duratior 
; the download. 


Pseudocode : 


dwn I d : 

turn off interrupts; /* this routine uses polled ACIA only *i 
checksum =0; 
f i r st_nyb_f I ag = 0; 
e r r o r_f lag = 0 ; 
char = p_g etcharl) ; 

do while (char <> $02); /* look for “B */ 

c h a r = p_g etcharO ; 

end; 

do while ((char <> $03) AND (error flag = 0)); /* look for “C ^ 

i. i f ( c h a r = ' $ ' ) 

then do; 

char = p_getchar(); 
do while (char <> 'A'); 
char = p_g etchar(); 

end; 

mem_addr = p_getword(); /* get the address */ 

offset = 0; 

call p_g et c omma ( ) ; /* get the comma */ 

end; 
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e I se do; 

if (char <> $0A) OR (char <> $0D) OR (char <> ' ') 
then do; 

if (f i r st_nyb_f L ag = 0) 
then do; 

nybble_1 = a_to__h(char) ; 

if (nybble_1 = $FF) then error_flag = $F 
f i r st_nyb_f L ag = $FF 

end; 

else do; 

nybble_2 = a_t o_h ( c h a r ) ; 

if (nybble_2 = $FF) then error_flag = $F 
byte = nyb b L e_1 : nyb b I e^2 ; 
memCmem_addr3 = byte; 
checksum = checksum + byte; 
f i r st__nyb_f I ag = 0; 
mem_addr = mem_addr +1; 

end; 

end; 

end; 

char = p_g etcharO; 

end; 

if (error_flag <> 0) 

then call p__msg__h nd I r ( ' b ad__da t a ' ) 
else do ; 

char = p_getchar(); 

do while (char <> ’S'); /* look for the S */ 
char = p_g etcharO; 

end; 

xmt_chk_sum = p_getword(); 
if (checksum <> xmt_chk_sum) 

then call p_ms g_h nd I r ( ' B AD RUN'); 
else call p_m sg_h nd I r ( ' GOOD RUN'); 

end; 

end down load; 


; This routine obtains the current version number of this software, and 
; transmits it to the serial port. 

; IMPORTANT: the assumption is that the version number is always 

; , two BCD digits of the form M.N 


Pseudocode : 


put_^ve r s i on : 

save regs; 

accum = (version_num AND $F0) >> 4; 
call putchar (accum) ; 
call putchar('.'); 
accum = version_num AND $0F; 
call putchar (accum) ; 
unsave regs; 
end put version; 
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; This routine obtains the current version number of this software, and 
; displays it, properly formatted on the hexpad display panel. 


IMPORTANT: the assumption is that the version number is always 
two BCD digits of the form M.N 


Pseudocode : 


o u t_v e r s i o n : 

save regs; 

di sp L ay_wo rdC43 =3; 

display_wordC3D = (version_num AND $F0) >> 4; 
d i sp L ay_wo rdC2D = version_num AND $0F; 
di sp I ay_wo rdCm = $80; 
d i sp L ay_wo rdCOD = $80; 
call di sp I ay_hnd I r ; 
unsave regs; 
end out version; 



; This is a 8 X 8 multiply similar to mp mult except used only for singl 
; precision multiplication. The multiplTer is loaded into sp_mult1, the 
; multiplicand in sp muLt2 and the 16 bit product is returned in sp proc 



Pseudocode : 


s p_m u 1 1 : 

save regs; 

msbyte of s p_m u L 1 2 = 0 ; 
sp_product = 0; 
doi =0to7; 

sp_muLt1 = sp_mult1 >> 1 ; 

if (carry = 1) then s p_p roduct = s p_p roduct + s p_m u 1 1 2 ; 
sp_mult2 = sp_muLt * 2; 

end; 

unsave regs; 
end sp mult; 


; This routine sets the duty cycle of the selected PWM timer to the desi 
; value. The value input by the user is given as a %-age duty cycle, wi 
; theinput %-age being the "time high". The value for selecting the ti 
; can be either "1" or "2", If invalid entries are made, error messages 
; arje sent to the terminal. 



Pseudocode: 

set_duty_cyc Le : 

save regs; 

if ( (command_bufferC13 < #$31) OR ( c omma nd_buf f e r m > #$32)) 
then call msg__h nd I r ( ' D IGI T NOT 1 OR 2'); 
else do; 

temp = command bufferCIU - #$31; 
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cmd_out_ptr =2; 

X = getbyteO; 

if ((i_o_fLags & #asc i i_hex_f L ag) = 0) 

then call tnsg_hnd L r ( • D I GIT OUT OF RANGE 0-F'); 
e L s e do; 

y = d_t o_h ( X ) * 2 ; 

if ( (compute_f L ags 8 #ove r_1 0_f I ag) != 0) 

then call msg_h nd L r ( ' D I GI T OUT OF RANGE 0-9'); 
else do; 

if (y > #$AE) 

then call ms g_h nd I r ( ' D UTY CYCLE VALUE OU' 
OF RANGE 0-87%'); 

else do; 

time r_c s r = #$E0 ; 
if (temp == 0) 
then do; 

timer_csr = #$C4; 
timer_csr = #$0B; 
timer_data = du t y_l ow_t b I Cy D ; 
timer_data = dut y_l ow_tb I Cy+1 
timer_data = du t y_h i_t b I C yD ; 
pwm_value = du t y_h i_t b I Cy3 ; 
timer_data = du t y_h i_t b I Cy+1 D 
timer_csr = #$E3; 
timer_csr = #$24; 

end; 

else do; 

time F_c sr = #$C8; 
timer_csr = #$0C; 
timer_data = du t y_l ow_t b I C y3 ; 
timer_data = duty_l ow_tb lCy+1 
timer_data = du t y_h i_t b I C yD ; 
timer_data = du t y_h i_t b I C y+1 T 
timer_csr = #$E4; 
time r_c s r = #$2 8; 

end; 


unsave r egs ; 
end set duty cycle; 


PERCENT DUTY CYCLE TO PWM COUNT TABLE 


uty_lo__tbl: 

.byte $C6,$00,$C6,$00,$C4^$00,$C2,$00 
.byte $CO,$00,$BE,$00,SBC,$00,$BA^$00 
.byte $B8^$00,$B6,$OOy.$B4,$00,$B2,$00 
.byte $B0^$00,$AE,$00,$AC,$00^$AA,$00 
.byte $A8,$00,$A6,$00,$A4,$00,$A2,$00 
.byte $AO,$00,$9E,$00,$9C,$00,$9A,$00 
.byte $98, $00, $96, $00, $94, $00, $92, $00 
.byte $90,$00,$8E,$00,$8C,$00,$8A,$00 
.byte $88, $00, $86, $00, $84, $00, $82, $00 
.byte $80,$00,$7E,$00,$7C,$00,$7A,$00 
.byte $78, $00, $76, $00, $74, $00, $72, $00 
.byte $70,$00,$6E,$00,$6C,$00,$6A,$00 
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.byte $68, $00, $66 ^$00, $64, $00, $6 2, $00 
.byte $60,$00,$5E',$00,$5C,$00,$5A,$00 
.byte $58, $00, $5 6, $00, $54, $00, $5 2, $00 
.byte $50,$00,$4E,$00,$4C,$00,$4A,$00 
.byte $48, $00, $46, $00, $44, $00, $42, $00 
.byte $40,$00,$3E,$00,$3C,$00,$3A,$00 
.byte $38, $00, $36, $00, $34, $00, $32, $00 
.byte $3 0, $00, $2 E, $00, $2 C, $00, $2 A, $00 
.byte $28, $00, $2 6, $00, $24, $00, $2 2, $00 
.byte $20,$00,$1 E,$00,$1C,$00,$1 A,$00 

duty_h i_tb L : 

.byte $02, $00, $02, $00, $04, $00, $06, $00 
.byte $08,$00,$OA,$00,$OC,$00,$OE,$00 
.byte $1 0,$00,$1 2,$00,$1 4,$00,$1 6, $00 
.byte $1 8,$00,$1 A,$00,$1 C,$00,$1 E,$00 
.byte $20, $00, $2 2, $00, $24, $00, $26, $00 
.byte $2 8, $00, $2 A, $00, $2 C, $00, $2 E, $00 
.byte $30, $00, $3 2, $00, $34, $00, $3 6, $00 
.byte $3 8, $00, $3 A, $00, $3 C, $00, $3 E, $00 
.byte $40, $00, $42, $00, $44, $00, $4 6, $00 
.byte $48,$00,$4A,$00,$4C,$00,$4E,$00 
.byte $50, $00, $52, $00, $54, $00, $5 6, $00 
.byte $58,$00,$5A,$00,$5C,$00,$5E,$00 
.byte $60, $00, $62, $00, $64, $00, $66, $00 
.byte $68,$00,$6A,$00,$6C,$00,$6E,$00 
.byte $70, $00, $72, $00, $74, $00, $76, $00 
.byte $78,$00,$7A,$00,$7C,$00,$7E,$00 
.byte $80, $00, $82, $00, $84, $00, $86, $00 
.byte $88,$00,$8A,$00,$8C,$00,$8E,$00 
.byte $90, $00, $92, $00, $94, $00, $96, $00 
.byte $98,$00,$9A,$00,$9C,$00,$9E,$00 
.byte $A0,$00,$A2,$00,$A4,$00,$A6,$00 
.byte $A8,$00,$AA,$00,$AC,$00,$AE,$00 


; This routine, called from either the terminal or the front panel keypc 
; allows the user to set and clear individual bits that control various 
; "devices". These devices are divided into various "classes" which del 
; which section of code handles the device specific functions. The "dev 
; which can be controlled include the audio buzzer, the warning LEDs, ti 
; user's load requests, the PWM control ports, and the load current over 
; trip control bits. 


device 0 
devi ce -1-6 
device 7-11 
device 12-17 
devi ce 1 8-23 
device 24-25 


audible alarm 

user load requests 1 thru 6 
overload trip resets for loads 1 thru 5 
PWM buffer #1 controls 1 thru 6 
PWM buffer #2 controls 1 thru 6 
Yellow, and Red LEDs 


; If a digit out of the range of 0 to 9 is entered for either digit of t 
; bit number or out of the range 0 to 1 for the desired state (1=0N), or 
; the bit number exceeds 25, then an appropriate error message is sent t 
; controlling I/O device (terminal or keypad). In addition, if the user 
; attempts to set a bit in the range 6 - 10, the equivalent of "t ripping 
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a load's circuit breaker, a warming message is displayed and no action is 
taken. 


Pseudocode : 
set bit: 


save r egs ; 

i f ( (command_buf f e rC1 3 < $30) OR ( c omma nd_bu f f e r Cl 3 > $39)) 
then do; 

if ( command_buf f er C03 = 'D') 

then call displa y_e rror(#$04) ; 

else call msg_hnd I r ( ' DIGIT OUT OF RANGE 0-9'); 

end; 

else do; 

sb_temp = command_buf f erCI 3 << 4; 

i f ( ( command_buf f e r C23 < $30) OR ( c omma n d_buf f e r C23 > $39)) 
then do; 

if ( command_buf f erC03 = 'D') 

then call d i sp I ay_e r r o r ( # $04) ; 

else call msg_h nd I r ( ' D I GIT OUT OF RANGE 0-9'); 

end; 

else do; 

sb_temp = sb_temp OR ( c omma nd__buf f e r C23 AND #$0F); 
if ( (command_buf f erC33 < $30) OR 

( c ommand_bu f f e r C3 3 > $31)) 

then do; 

if ( command_buf f erC03 = 'D') 

then call di sp L ay_e r r o r ( #$07) ; 

else call msg_hnd I r ( ' DIGIT NOT A '1' OR '2''); 

end; 

else do; 

i f ( c om ma nd_buf f e r C3 3 = $30) 
then cflag = 0; 
else cflag = 1; 
if(sb_temp >= max_num_devs ) 

/* max_num_devs = #$26 */ 

then do; 

iflcomman d_b ufferC03='D') 

then call d i s p I ay_e r ro r ( # $09) ; 

else call msg_hnd L r ( ' I NVAL I D DEVICE NUMBER 

end; 

else do; 

if(sb_temp >= $20) 

then sb_temp = sb_temp - #$0C; 
else if(sb_temp >= $10) 
then do; 

sb_temp = sb_temp - #$06; 
sb_temp = sb_temp << 1 ; 
i = sb_ms k_tb lCsb_temp3 ; 
j = sb_ms k_tb 1+1 Csb_t emp3 ; 

switch (j); 

case 0 : 

if (cflag = 1) 

then alarm_flags = alarm__flags OR i; 
else alarm flags = alarm flags AND “i; 
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break; 

easel: 

if(cfLag = 1) 

then user_ld_req = user_Ld_req OR 'i ; 
else user_ld_req = user_Ld_req ANfr “i; 
break; 
c a s e 2 : 

if (cfLag = 1) 
then do; 

0 V r L d_t rip = ovrL d_t rip AND ”i; 
ovrld_cnt = ovr ld_cnt_max ( sb_temp - 7); 

1 = #enabl e_b e L L ; 
aLarm_flags = aLarm_flags AND “i; 

end; 

else do; 

if ( command_buf f erCOD = 'D') 

then call d i sp L ay_e r r o r ( #$08) ; 

else call msg_hnd L r ( ' CAN ' T TRIP OVERLOAD 

PROTECTOR • ) ; 

end; 
break; 
case 3 : 

ifCcfLag = 1) 

then call ent r L__pwm_output ( i OR #$80); 
else call ent r l_pwm_output ( i ) ; 
break; 
case 4: 

if(cflag=1) 

then stow__leds = stow_leds OR i; 
else do; 

stow_leds = stow_leds AND ”i; 

I ed_ou t_l a t c h = stow_leds; 
end; ~ 

break; 

end; 

end; 

end; 

end; 

un save regs ; 
end set bit; 


SET BIT MASK TABLE 


s b_tn s k_t b L : 

• byte $80, $00 ; audio buzzer. Class $0 1 - 

.byte $08, $01 ; User load requests 1-6, Class 1 

.byte $10, $01 

.byte $20, $01 

.byte $40, $01 

.byte $80, $01 

.byte $04, $01 

.byte $08, $02 ; Overload trip controls 1- 5, Class 2 

.byte $10, $02 
.byte $20, $02 
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. byte 

$40, $02 

. byt e 

$80, $02 

.byte 

$00, $03 

. byte 

$01, $03 

.byte 

$02, $03 

.byt e 

$03, $03 

• byte 

$04, $03 

.byt e 

$05, $03 

.byte 

$06, $03 

.byte 

$07, $03 

.byte 

$08, $03 

.byte 

$09, $03 

.byte 

$0A,$03 

.byte 

$0B,$03 

.byte 

$01, $04 

.byte 

$02, $04 


; PWM Control arrays 1 & 2 (6 outputs each) 
; Class 3 


; LED controls (Yellow, Red) Class 4 


; This routine takes as its input the contents of the accumulator and 
; sets or clears the selected PWM control output bit. The contents of 
; the accumulator are encoded as follows: Bit 7 is a "1" if the PWM control 

; bit is to be set, a "0" if the PWM control bit is to be cleared. Bits 0-3 

; are the number (or "address" if you will) of the bit to be set/cleared. 

; Values between $00 and $05 are in PWM control array 1, and values between 

; $06 and $0B are in PWM control array 2. The bit number is used as an 

; index into the array pwm_msk_tbl whose entries are the bit pattern to 
; be used in turning on or off the PWM control. In addition, if bit 7 of th( 
; pwm__tbl_msk array entry is on then the mask is for PWM control array 2. 


Pseudocode : 


c nt r l_pwm_out put : 
save regs; 

i = pwm_ms k_tb I Cva lue AND #$0FD 
if (i >= 0) 
then do ; 

if (value < 0) 
then do; 

stow_pwm1 = stow_pwm1 OR i ; 
array_sel1 = stow_pwm1; 

end; 

e I se do; 

stow_pwm1 = stow_pwm1 AND "i; 
array_sel1 = stow_pwm1 ; 

end; 

end; 

e I s e do; 

i = i AND #$7F; 
if (value < 0) 
then do; 

stow^pwm2 = stow_pwm2 OR i; 
array_sel2 = stow_pwm2; 

end; 

else do; 

stow__pwm2 = stow_pwm2 AND “i; 
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a r ray_s e 12 

end ; 


end; 

unsave regs; 
end cntrl pwm output; 


stow pwm2; 



PULSE MASK TABLE FOR CNTRL PWM OUTPUT 



pwm__ms k_tb L : 

.byte $01 ,$02, $04, $08, $1 0, $20 
.byte $81 ,$82, $84, $88, $90, $A0 



; This routine converts the A/D reading in frez_tetnp into a "%-age coLdr 
; product, which is an indication of the state of the freezer load. 



Pseudocode: 


fin d_p rod: 

save regs; 

if ( f r ez_t emp Cl 3 < 0) 
then i= 0; 
else do; 

i = frez_tempnD >> 1; 
save flags; 
i = i >> 1 ; 
save flags; 

i = (f rez_tempC03 >> 3); 
unsave flags; 
if (carry bit = 1) 
then i = i OR $40; 
unsave flags; 
if (carry bit = 1 ) 
then i = i OR $20; 
i = i - $50; 
if (i < 0) 

then i = 0; 
else if (i > $35) 
then i = $35; 

end; 

prod = prod_pct_tb ICiD; 
unsave regs; 
end find prod; 


; PERCENTAGE OF PRODUCT TABLE FOR FIND-PROD 

prod pet tbl : 


.byte 

2, 

4. 

6, 

8, 

10, 

12, 

14, 

16, 

20, 

22, 

24, 

26 

.byte 

28, 

30, 

32, 

34, 

36, 

40, 

42, 

44, 

46, 

48, 

50, 

52 

.byte 

54, 

56, 

60, 

62, 

64, 

66, 

68, 

70, 

72, 

74, 

78, 

80 

.byte 

82, 

84, 

86, 

88, 

90, 

92, 

94, 

98, 

100, 

1 02, 

104, 

106 
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.byte 108, 110, 112, 116; 118, 120 


; This routine, called on a one second interval, tests to see if any of the 
; string currents have fallen below a specified level, i.e. if the following 
; expression is false for any of the strings, then the string_fault flag is 
: set . 


branch current(N) >= (total_chgr I/number of strings) - str fault offset 


’suedocode : 

: e s t_s t r i ng_I : 

save regs; 

Isword of dividend = total chgr I; 
msword of dividend = 0; ~ 

Isbyte of divisor = num_pwr_st r i ngs ; 
msbyte of divisor = 0; 
quotient = mp_div(); 

X = 0 ; 

quotient = quotient - st r_f aul t_of f set; 

do while ((x < num_p w r_s t r i ngs ) AND (branchIC x D >= quotient)) 

X = X + 1 ; 

end; 

if (x = num_pwr_st r i ngs) 
then string_fault =0; 
else string_fault =1; 
unsave regs; 
end test string I; 


This routine handles the dumping of s t a t e_o f_c hg , corrected state of charge 
equalization count and pwm value for the dump state routine. 


seudocode : 


ump_s o c : 

save regs; 
call putchar ( ' D ' ) ; 
call putbyte ($00) ; 
call msg_hndlr(' = '); 
call put_so c ; 
call put c ha r ( $20) ; 
call putchar ($20) ; 
call put char('D'); 
call putchar ($40) ; 
call msg_hndlr(* = '); 
call put__c so c ; 
call put char ($20) ; 
call put c ha r ( $20) ; 
call putchar ( ' D ' ) ; 
call putchar ($41 ) ; 
call msg hndlr(' = '); 
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call put_equa L ; 
call put c ha r ($20) ; 
call put char ($20) ; 
call putchar('D');' 
call put c h a r ( $42) ; 
call msg_hndlr(' = '); 
call put_pwm ; 
call putchar('CR'); 
call putchar('LF'); 
unsave regs; 
end dump soc; 



; This routine handles the dumping of the switch and load states for th( 
; dump state routine. 



Pseudocode : 


d u m p_s w_s t a t e s : 

save regs; 

call putchar('S'); 

call putchar('l'); 

accum = alarm_30 AND inhibit_bit; 

call pu t_on ; 

call putchar(‘S'); 

call putchar('2'); 

accum = alar m_3 0 AND moto r_t e m p ; 

call put_on ; 

call putchar('L'); 

call putchar('l'); 

accum = stow_leds AND bit3; 

call put_of f ; 

call putchar('L'); 

call putchar('2'); 

accum = stow_leds AND bit4; 

call put_of f ; 

call putchar('L'); 

call putchar('3'); 

accum = stow_leds AND bit5; 

call put_of f ; 

call putchar('L'); 

call putchar('4'); 

accum = stow_leds AND bit6; 

call put_of f ; 

call pu tc ha r ( ' L ' ) ; 

call put char('5‘); 

accum = stow_leds AND bit7; 

. call put_off; 

call putchar('L'); 

callputchar('6'); 

accum = stow_leds AND bit2; 

call put_of f ; 

call putchar('CR'); 

call putchar('LF'); 

unsave regs; 
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end dump sw states; 


put_on: 

call putcharC'-'); 
i f (accum = 0) 

then call put c h a r ($3 1 ) ; 
else call putchar($30) ; 
call putcharC' '); 
end put on; 


put___of f : 

call putcharC'-'); 
if Caecum = 0) 

then call put c ha r C $3 0) ; 
else call put c ha r C $3 1 ) ; 
call putcharC' '); 
end put off; 


This routine dumps the state of the 12 array enable lines during dump state 


Pseudocode : 

iump_a r ra ys : 

save regs; 

temp = St ow_pwm1 ; 

do i=31 to 36; 

call putcharC'A'); 
call putcharCi); 
call putcharC'-'); 
temp = temp >> 1 
if Ccarry = 0) 

then call put c h a r C ' 0 ' ) ; 
else call put c h a r C ' 1 ' ) ; 
call putcharC' '); 

end; 

temp = stow_pwm2; 
do i=31 to 36; 

call putcharC'A'); 
call putcharCi); 
call putcharC'-'); 
temp = temp >> 1 
if Ccarry = 0) 

then call put c h a r C ' 0 ' ) ; 
else call putchar C '1 ' ) ; 
call putchar C ' ' ) ; 

end; 

call putcharC'CR'); 
call put cha r C ' L F ' ) ; 
unsave regs; 
end dump arrays; 
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XXXXXX 

X 

XXXXX 

X 

X 

X 


XXXXX XXXXX XXXX 

X XX XX X 

X XX XX X 

XXXXX XXXXX X X 

X XXXX 

X XX XXXX 


X X 

XX XX 
X XX X 
X X 

X X 

X X 
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; This is the "main" control module. This module invokes all of the other 
; modules, either directly or indirectly. The routines called directly by 
; this module are listed below. The functions of the r un_t a s k_ma s t e r are man 
; but they are broken down into 4 regimes. 

/ 

; 1. background regime - the most fundamental loop for the system to 

; be in if nothing is happening. 


2. dataset_ready regime - entered only when the new dataset is 
available for signal averaging. 


3. 100 msec regime - within the data set_r eady regime. It is within 
this area that the signal averaging multimeter functions and max 
power control are done. 


4. 1 second regime - this area is devoted primarily with the 
handling of the clock and machine state considerations. 



Pseudocode : 


r u n_t a s k_m aster: 

do while (1); 

if (dsp ly_pend_f I ag = 1) then call d i sp I ay_d i g i t s ; 
if (dataset_ready_f I ag = 1) 
then do; 

strobe watchdog timer; 

if ( s e r i a L_c md_f I ag OR k ybd_c md_f I ag = 1) 
then call cmd intrp; 
if (pwm_m_flg = lT 
then do; 

call abs_cnvt ; 
if ( r un_f lag = 1)); 
then do; 

call battery_state_of_c hg; 
if ( ma x_pw_c nt r I = 1) 

then call max_pwr_t rack ; 
if ( (dump_state_f I ag =1) 

AND (byte_count = 0)) 
then call dump__state; 

end; 

dataset__ready_f lag = 0; 
pwm^m_flg = 0; 

mmf_update = mmf_update - 1; 

end; 

if (mmf_update = 0) 
then do; 

call mu 1 1 i me t e r^f un c ; 
mmf_update = 3; 

end; 

end; 

if (one_sec flag = 1) 
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then do ; 

call t es t__st r i ng_I ; 
call f i nd_t ime; 
if (alarm_30 AND bit6 <> 0) 
then do; 

"reset" the 30 min alarm; 
dump_state^f Lag =1; ^ 

end; 

=■ if (run_flag = 1) 

then do; 

if (max_pw_cntr L =0) 

then call di sc rete_a r ray cntrl; 
call cor rect__state_of_chg; 
call de t e r_ma c h_s t a t e ; 

end; 

else s t ow_l eds= L ed_ou t_l a t c h=s t ow_l eds XOR #rled 
call c h k_f o r_ov r I d; 
one_sec_flag = 0; 

end; 

end; 

end run task master; 



; This routine is awakened when the pwm_m_flg is set to indicate that 
; it is time to update the control point. 


Note: if (direction <> 0) then duty cycle incr's 
if (direction = 0) then duty cycle deer's 





Pseudocode : 

ma x_powe r_t rack: 

save regs; 

old_power = new_power; 

new_power = (abs__battery_V + $100) * abs_tota L_c hg r_I ; 
delta_power = new_power - oLd_power; 
if ( (de L t a_powe r < 0) AND ( d i r_c hg_c nt r = 0)) 
then do; 

direction = direction XOR 1; 
dir_chg_cntr =2; 
step = sma L L ; 

end; 

else if (delta_power > oLd_power * 2"(-big)) 
then step = large; 
else step = small; 
if (pwm_value <= min_pwm) 
thendo; 

di recti on =1; 
step = large; 

end; 

if ((pwm_value >= max_pwm) OR ( (tota l_chg r_I > max chgr_I) 

OR (abs_battery_V > bat_V_Limit) 

OR (motor_temp = 1) 

OR (string 1 V < min array volts) 
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then do ; 

direction = 0; 
step = small; 

end; 

if (directio n_b it = 0) then step = - step; 
pwm_value = pwm_value + step; 
if (pwm_value > max_pwm) 

then if (direction <>0) 

then pwm_value = max_pwm; 
else pwm_value = 1; 

if ((pwm_value < 1 count) OR (inhibit = 0)) 
then do; 

pwm_va I ue = 1 ; 
turn_on_flag = 0; 

end; 

else turn_on_flag = 1; 
do ; 

disable ints; 
timer_csr = $0B 

timer_data = $C8 - pwm_value; /* Load downtime */ 
timer_data = $00 

timer_data = pwm_value; /* load uptime */ 

time r_d a t a = $ 0 0 
if ( t u r n_o n_f Lag = 1 ) 

then a r r ay_se I 1 =a r ray_se 12= s tow_pwm1 = s t ow_pwm2 = 
else a r r ay_s e L 1 =a r r ay_s e 1 2 = s t ow_p wml = s t ow_p wm2 = 
end; 

enab Le ints; 

end; 

settle_time = $03; 
if ( d i r_c hg_c n t r <> 0) 

then dir_chg_cntr = dir chg cntr - 1; 
unsave regs ; 
end max power track; 


#$3F; 

#$ 0 ; 


This routine Looks through a table of commands for a match to the first 
character that it finds in the command buffer. The next two locations in 
the table hold the jump address of the routine to handle the requirement. 
The corresponding routine is invoked. Since the data in the command buffer 
could be the password, this is checked first. Failing this test, the input 
is tested to see if it is one of the possible command words. If so, that 
task is initiated. If no command word is matched a "WHAT?" message is 
sent to the appropriate port. 

If the msb of the table character is set, it indicates that the function is 
a multimeter display function. In this case, the ascii representation of 
the channel number in the command buffer is moved to mu 1 1 i me t e r_d a t a , 
the display function starting address is retained in multimeter addr and 
the mu L t i me t e r_f L ag is set. 

Upon completion of this task the following actions are taken: 

1. control is returned to cmd intrp 

2. a prompt, "CR LF is sent to the serial port, using 
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msg hnd L r 



Pseudocode : 


cmd_ijit r p : 

save pegs; 
cmd_out_ptr =0; 

if ( kybd_cmd_f L ag OR s e r i a L_cmd_f I ag = 1) 
t hen do; 

if ( kybd_cmd_f L ag = 1) 
then do; 

index = 0; 

do while ( (command_buf f erCi ndexD = pa s s wo rdC i nde 

AND (index < 4)); 
index = index + 1; 


end; 

if (index = 4) 
then do; 

va I i d_pa s s wo r d =1; 
call d i sp I ay_c I r ( ) ; 

end ; 

else do; 

call displa y_c I r O ; 
if ( (command_buf f erCI D < $3A)) 
then do; 

if (va I id_password = 0) then 

base_addr = _cmd__tab lei ; 
else base_addr = _cmd_table3; 
call _find_func; 
kybd_cmd_f I ag = 0; 
cmd_out_ptr = 0; 
cmd_in_ptr = 0; 
end; 

else do; 

c m d_o u t_p t r = 1 ; 

if ( va I i d_pa s s wo r d = 0) then 

base_addr = _cmd_table2; 
else base_addr = _cmd_table4; 
call _f i nd_f un c ; 
k ybd_cmd_f I ag = 0; 
cmd_out_ptr = 0; 
cmd_in_ptr = 0; 
end; 

end; 


end; 

else do; 

base_addr = _cmd_table5; 
call _find_func; 
call msg_ hnd I r ( p romp t ) ; 
seri a l_cmd_f lag = 0; 
cmd_out_ptr = 0; 
cmd_in_ptr = 0; 

end; 
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end; 

unsave regs; 
end cmd_intrp; 

find_func: procedure; 
i ndex = 0; 

do white ( (command_buf f e r Ccmd_out_pt rl <> 

($7F AND bas e_a ddrCindexD)) AND 

(base_addr Ci ndexD <> 0)); 
index = index + 3; 

end; 

if ( ba s e_add r C i nde xD AND $80 <> 0) 
then do; 

mutt i mete r_f Lag = 1 ; 

mu L t i me t e r_d a t a = c omma nd_bu f f e r Cl D ; 
mu L t imet e r_dat a+1 = c omma nd_bu f f e r C2 3 ; 
mu L t i me t e r_add r = base_addr Ci ndex + 13; 

end; 

if ( b a s e_add r C i nde x3 = 0) 
then do; 

i f ( kybd_cmd_f I ag = 1) then call dispLay_huh; 
else call put_huh ; 

end; 

else do ; 

j u m p_a d d r = bas e_a ddrCindex + 13; 
call routine Located S jump_addr; 

end ; 

end find func; 


This routine gathers N channeLs of data, sequent i a L Ly, and stores the 
resuLts in memory. The routine set the mux channeL number, waits for 
settLing, starts the conversion, poLLs for conversion compLetion and then 
stores the resuLt. 


Note: entry num, next seLdom and pass num are zeroed at init 


seudocode : 

d c_hnd L r : 

save regs; 
temp = pia_csra; 
if (temp AND bit 6 <> 0) 
then caLL knock_down; 
if (temp AND bTt 7 <> 0) 
then do; 

deer pwm_mod_t i me r ; 
if (pwm_mod_timer = 0) 
then do; 

pwm_mod_t i me r = 25; 
pwm_m_fLg =1; 
end; 

caLL scan_kybd; 
if ( s e 1 1 L e_t i m e = 0 ) 
then do; 
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if ( da t a set_ready_f I ag = 0) 
then do; 

"OFTEN READS" 
next_often =0; 

do while next_often <= num_of_of t.en_reads; 
select the often_read mux channel; 
adc_lo = 0; to start convers' 

if ( n e X t_o f t e n = 0 ) 
e I se do ; 

rearrange adc_value; 

if (adc_value < 0) then remove sign b' 
complement the value; 
often_readCent ry_num, (next_of ten-1 ) *3< 

adc_va lue; 

end; 

do while (adc_lo AND adc_not_busy = 0); 

end; poll for conversion compi 

adc_value = adc_h i : adc_l o; 
next_often = next_often +1; 

end; 

rearrange adc_value; 

of t en_r eadC ent r y_num , ( nex t_o f t en-1 ) *3 2D = adc_vj 
"SELDOM READS" 

if (next_seldom > num_of_se Idom reads) 
then next_seldom = 0; 
else next__seldom = next_seldom + 1; 
select seldom_read mux channel; 

adc_lo = 0; to start conversion 

if (pass_num >= max_pass_num) 
then do; 

dataset_r eady_f I ag = 1; 
pass_num = 0; 
entry_num = 0; 
end; 

else do; 

pass_num = pass_num +1; 
entry_num = entry_num + 1; 
end; 

do while (adc_lo AND adc_not_busy = 0); 

end; poll for conversion comp 

se ldom_readCnext_se IdomD = rearranged adc; 

end; 

end; 

else settle_time = settle_time - 1; 

this is the settl e_t ime tf^aT is set 
when the PWM value has been changed. 

A value of 5 for settl e_t ime will 
suppress any current measurements for 
20 msec 

if ( (one_sec_f lag = 0) AND (one_sec_t ime r = 0)) 
then one_sec_t ime r = 250; 
else if (one sec flag = 0) 
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then do ; 

deer one_s e c_t i me r; 

if ( one_se e_t i me r = D) then one_sec_flag =1; 
end ; 

if ((aLarm_^30 AND inhibit_bit <> 0) AND (alarm_30 AND panicO 0) 
then inhibit = 1; 
else inhibit = 0; 
if (ala'rm_30 AND panic = 0) 
then caLL knock_down; 

end; 

unsave regs; 
end adc hndLr; 


_knock_down : 

stow_Leds = I ed_out_l at c h = stow_leds AND $03; 
user_ld_req = inhibit = array_seL1 = array_sel2 = 0; 
strobe watchdog timer; 
end knock down; 


This routine is the "main" routine that calls all of the routines that 
deal with the elements of calculating the state of charge of the battery. 
It is fully executed only when the dat aset_r eady_f I ag is set. When all of 
these calculations are complete, this routine assigns a new value to 
bat V limit: 


Pseudocode; 

batter y_s tat e_o f _c h g : 
save regs; 

call c a I c_sy s_vo 1 1 s ; 
call c a I c_s t a t e_of_c hg ; 
call ca I c_equa l_count ; 

if (state_of_chg < 1) OR (equal_count >0) 
then bat__V_limit = equal_V; 
else bat_V_limit = float_V; 
unsave regs; 

end batter y_state of charge; 


This routine takes the value of bat_temp, shifts it right by 4 subtracts 
$D and uses the result as an index into the each of three tables. The 
first one is the float voltage table, the second one is the equalization 
voltage table and the last is the minimum voltage table. This technique 
greatly reduces the execution time and simplifies the software. 


Pseudocode : 

:a I c_sys_vo Its: 

save regs; 

index = bat_temp >> 4; 
index = index - $D; 
if (index < 0) 
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then index = 0; 
index = index * 2; 
float V = float tab leCi ndexD ; 
if (fToat_V > aFs_max_bat__V) 

then float_V = abs_max_bat_V; 
equal_V = equa l_t ab I e C i ndexD ; 
if ( e q u a l_V > a b s_m a x_b a t_V ) 

then equal_V = abs_max_bat_V; 
min_bat_V = m i n_ba t_t ab I e Ci ndexD ; 
if (mi n_b a t_V < a b s_m i n_b a t_V ) 

then min_bat_V = abs_mi n_bat_V ; 
unsave pegs; 
end ca I c_sy s_vo I t s ; 

The following are the lookup tables for float_volts, equal_volts and 
min b a t_v olts for the equation: 

value = ba se_vo 1 1 ag e/ c e 1 1 * num_of_b a t_c e 1 1 s * 

(1 + .0022 * (20.92 * (Vt - 2.56))) 

where base_vo Itage/ ce 1 1 = 2.4 for float_V 

= 2.7 for equa l_V 
= 1.9 for mi n_b a t_V 

In order to find the index to a value in the table, take the raw A/D 
value for Vt, shift right 4 bits and subtract $0D. 

NOTICE: Vt, as shown below, is represented in "real volts" format, i.e. 
the number represents the number of 1/1000's of volts. To convert this 
value to what is actually stored in memory, it must be divided by 4. 





FLOAT 

VOLTAGE 

TABLE 


temp 


index 

Vt 

hex value 

dec value 

61 

deg 

C 

00 

340 

012A 

119.3 

60 

deg 

C 

01 

380 

012b 

119.7 

58 

deg 

C 

02 

3C0 

012C 

120.1 

57 

deg 

C 

03 

400 

012D 

120.4 

56 

deg 

C 

04 

440 

012E 

120.8 

54 

deg 

C 

05 

480 

012F 

121.2 

53 

deg 

C 

06 

4C0 

012F 

121.6 

52 

deg 

C 

07 

500 

0130 

122.0 

50 

deg 

C 

08 

540 

0131 

122.3 

49 

deg 

C 

09 

580 

0132 

122.7 

48 

deg 

C 

OA 

5C0 

0133 

123.1 

46 

deg 

C 

OB 

600 

0134 

123.5 

45 

deg 

C 

OC 

640 

0135 

123.9 

44 

:d«g 

C 

OD 

680 

0136 

124.3 

42 

deg 

C 

OE 

6C0 

0137 

124.6 

41 

deg 

C 

OF 

700 

0138 

125.0 

40 

deg 

C 

10 

740 

0139 

125.4 

38 

deg 

C 

11 

780 

013A 

125.8 

37 

deg 

C 

12 

7C0 

013B 

126.2 

36 

deg 

C 

13 

800 

013C 

126.5 

34 

deg 

C 

14 

840 

013D 

126.9 
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33 

deg 

C 

15 

880 

013E 

127.3 



32 

deg 

C 

16 

8C0 

013F 

127.7 



30 

deg 

C 

17 

900 

0140 

128.1 



29 

deg 

C 

18 

940 

0141 

128.5 



28 

deg 

C 

19 

980 

0142 

128.8 



26 

deg 

C 

1A 

9C0 

0143 

129.2 



25 

deg 

C 

IB 

AOO 

0144 

129.6 



24 

deg 

C 

1C 

A40 

0144 

130.0 



22 

deg 

C 

ID 

A80 

0145 

130.4 



21 

deg 

C 

IE 

ACO 

0146 

130.7 



20 

deg 

C 

1 F 

BOO 

0147 

131.1 



18 

deg 

C 

20 

B40 

0148 

131.5 



17 

deg 

c 

21 

B80 

0149 

131.9 



16 

deg 

c 

22 

BCO 

014A 

132.3 



14 

deg 

c 

23 

COO 

014B 

132.7 



13 

deg 

c 

24 

C40 

014C 

133.0 



12 

deg 

c 

25 

C80 

014D 

133.4 



10 

deg 

c 

26 

CCO 

014E 

133.8 



9 

deg 

c 

27 

DOO 

014F 

134.2 



8 

deg 

c 

28 

D40 

0150 

134.6 



6 

deg 

c 

29 

D80 

0151 

134.9 



5 

deg 

c. 

2A 

DCO 

0152 

135.3 



4 

deg 

c 

2B 

EOO 

0153 

135.7 



2 

deg 

c 

2C 

E40 

0154 

136.1 



1 

deg 

c 

2D 

E80 

0155 

136.5 



-0 

deg 

c 

2E 

ECO 

0156 

136.9 



-2 

deg 

c 

2F 

FOO 

0157 

137.2 



-3 

deg 

c 

30 

F40 

0158 

137.6 



-4 

deg 

c 

31 

F80 

0158 

138.0 



-6 

deg 

c 

32 

FCO 

0159 

138.4 



-7 

deg 

c 

33 

1000 

015A 

138.8 



“8 

deg 

c 

34 

1040 

015b 

139.1 



-10 

deg 

c 

35 

1080 

015C 

139.5 



Loat 

table: 









word 

$012A, 

$01 2B, 

$012C, 

$012D, $012E, 

$01 2F, 

$01 2F 



word 

$0131 , 

$0132, 

$0133, 

$0134, $0135, 

$0136, 

$0137 



word 

$0139, 

$013A, 

$013B, 

$013C, $013D, 

$013E, 

$013F 



word 

$0141 , 

$0142, 

$0143, 

$0144, $0144, 

$0145, 

$0146 



word 

$0148, 

$0149, 

$014A, 

$014B, $014C, 

$01 4d, 

$01 4E 



word 

$0150, 

$0151, 

$0152, 

$0153, $0154, 

$0155, 

$0156 



word 

$0158, 

$0158, 

$0159, 

$015A, $015B, 

$01 5C 



EQUALIZATION VOLTAGE TABLE 



temp 


index 

Vt 

hex va lue 

dec value 

61 

deg 

C 

00 

340 

0136 

124.3 

60 

deg 

C 

01 

380 

0137 

124.7 

58 

deg 

C 

02 

3C0 

0138 

125.1 

57 

deg 

C 

03 

400 

0139 

125.5 

56 

deg 

C 

04 

440 

013A 

125.9 

54 

deg 

c 

05 

480 

013B 

126.3 

53 

deg 

c 

06 

ACO 

013C 

126.6 

52 

deg 

c 

07 

500 

013D 

127.0 

50 

deg 

c 

08 

540 

013E 

127.4 


$0130 
$0138 
$0140 
$0147 
$014F 
$01 57 
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49 

deg 

c 

09 

580 

013F 

48 

deg 

c 

OA 

SCO 

0140 

46 

deg 

c 

OB 

600' 

0141 

45 

deg 

c 

OC 

640 

0142 

44 

deg 

c 

OD 

680 

0143 

42 

deg 

c 

OE 

6C0 

0144 

41 

deg 

c 

OF 

700 

0145 

40 

deg 

c 

10 

740 

0146 

38 

"deg 

c 

11 

780 

0147 

37 

deg 

c 

12 

7C0 

0148 

36 

deg 

c 

13 

800 

0149 

34 

deg 

c 

14 

840 

014A 

33 

deg 

c 

15 

880 

014B 

32 

deg 

c 

16 

8C0 

014C 

30 

deg 

c 

17 

900 

014D 

29 

deg 

c 

18 

940 

014E 

28 

deg 

c 

19 

980 

014F 

26 

deg 

c 

1A 

9C0 

01 50 

25 

deg 

c 

IB 

AOO 

0151 

24 

deg 

c 

1C 

A40 

01 52 

22 

deg 

c 

ID 

A80 

0153 

21 

deg 

c 

IE 

ACO 

0154 

20 

deg 

c 

1 F 

BOO 

0155 

18 

deg 

c 

20 

B40 

0156 

17 

deg 

c 

21 

B80 

0157 

16 

deg 

c 

22 

BCO 

0158 

14 

deg 

c 

23 

COO 

0159 

13 

deg 

c 

24 

C40 

015A 

12 

deg 

c 

25 

C80 

015B 

10 

deg 

c 

26 

CCO 

015C 

9 

deg 

c 

27 

DOO 

015D 

8 

deg 

c 

28 

D40 

01 5E 

6 

deg 

c 

29 

D80 

015F 

5 

deg 

c 

2A 

DCO 

0160 

4 

deg 

c 

2B 

EOO 

0161 

2 

deg 

c 

2C 

E40 

0162 

1 

deg 

c 

2D 

E80 

0163 

-0 

deg 

c 

2E 

ECO 

0164 

-2 

deg 

c 

2F 

FOO 

0165 

-3 

deg 

c 

30 

F40 

0166 

-4 

deg 

c 

31 

F80 

0167 

-6 

deg 

c 

32 

FCO 

0168 

-7 

deg 

c 

33 

1000 

0169 

-8 

deg 

c 

34 

1040 

016A 

-10 

deg 

c 

35 

1080 

016b 

equal 

_tab Le : 





'■i' ^ 

word 

$0136, 

$0137, 

$0138, 



word 

S013E, 

$013F, 

$0140, 



word 

$0146, 

$0147, 

$0148, 



word 

$014E, 

$014F, 

$0150, 



word 

$0156, 

$0157, 

$0158, 



word 

$015E, 

$015F, 

$0160, 



word 

$0166, 

$0167, 

$0168, 


127.8 

128.2 

128.6 

129.0 

129.4 

129.8 

130.2 

130.6 

131.0 

131.4 

131.8 

132.2 

132.6 

133.0 

133.4 

133.8 

134.2 

134.6 

135.0 

135.4 

135.8 

136.2 

136.6 

137.0 

137.4 

137.8 

138.2 

138.6 

139.0 

139.4 

139.8 

140.2 

140.6 

141.0 

141.4 

141.8 

142.2 

142.6 

143.0 

143.4 

143.7 

144.1 

144.5 

144.9 

145.3 


$0139, 

$013A, 

$013B, 

-$013C, 

$013D 

$0141, 

$0142, 

$0143, 

$0144, 

$0145 

$0149, 

$014A, 

$014B, 

$014C, 

$014D 

$0151, 

$0152, 

$0153, 

$0154, 

$0155 

$0159, 

$015A, 

$01 5B, 

$015C, 

$01 5D 

$0161, 

$0162, 

$0163, 

$0164, 

$0165 

$0169, 

$016A, 

$016B 
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MINIMUM BATTERY VOLTAGE TABLE 


temp 


index 

Vt 

hex' value 

dec va lue 

61 

deg 

C 

00 

340 

OOEC 

94.4 

60 

deg 

C 

01 

380 

OOEC 

94.7 

58 

deg 

C 

02 

3C0 

OOED 

95.0 

57 

deg 

C 

03 

400 

OOEE 

95.3 

56 

deg 

C 

04 

440 

OOEF 

95.6 

54 

deg 

C 

05 

480 

OOEF 

96.0 

53 

deg 

C 

06 

4C0 

OOFO 

96.3 

52 

deg 

C 

07 

500 

00F1 

96.6 

50 

deg 

C 

08 

540 

00F2 

96.9 

49 

deg 

C 

09 

580 

00F2 

97.2 

48 

deg 

C 

OA 

5C0 

00F3 

97.5 

46 

deg 

C 

OB 

600 

00F4 

97.8 

45 

deg 

C 

OC 

640 

00F5 

98.1 

44 

deg 

C 

OD 

680 

00F5 

98.4 

42 

deg 

C 

OE 

6C0 

00F6 

98.7 

41 

deg 

C 

OF 

700 

00F7 

99.0 

40 

deg 

C 

10 

740 

00F8 

99.3 

38 

deg 

C 

11 

780 

00F8 

99.6 

37 

deg 

C 

12 

7C0 

00F9 

99.9 

36 

deg 

C 

13 

800 

OOFA 

100.2 

34 

deg 

C 

14 

840 

OOFB 

100.5 

33 

deg 

C 

15 

880 

OOFB 

100.8 

32 

deg 

C 

16 

8C0 

OOFC 

101.1 

30 

deg 

C 

17 

900 

OOFD 

101.4 

29 

deg 

C 

18 

940 

OOFE 

101.7 

28 

deg 

C 

19 

980 

OOFE 

102.0 

26 

deg 

c 

1 A 

9C0 

OOFF 

102.3 

25 

deg 

c 

IB 

AOO 

0100 

102.6 

24 

deg 

c 

1 C 

A40 

0101 

102.9 

22 

deg 

c 

1 D 

A80 

0102 

103.2 

21 

deg 

c 

IE 

ACO 

0102 

103.5 

20 

deg 

c 

1 F 

BOO 

0103 

103.8 

18 

deg 

c 

20 

B40 

0104 

104.1 

17 

deg 

c 

21 

B80 

0105 

104.4 

16 

deg 

c 

22 

BCO 

0105 

104.7 

14 

deg 

c 

23 

COO 

0106 

105.0 

13 

deg 

c 

24 

C40 

0107 

105.3 

12 

deg 

c 

25 

C80 

0108 

105.6 

10 

deg 

c 

26 

CCO 

0108 

105.9 

9 

deg 

c 

27 

DOO 

0109 

106.2 

8 

deg 

c 

28 

D40 

010A 

106.5 

6 

deg 

c 

29 

D80 

010B 

106.8 

5 

deg 

c 

2A 

DCO 

010B 

107.1 

4 

deg 

c 

2B 

EOO 

010C 

107.4 

2 

deg 

c 

2C 

E40 

010D 

107.7 

1 

deg 

c 

2D 

E80 

010E 

108.0 

-0 

deg 

c 

2E 

ECO 

010E 

108.3 

-2 

deg 

c 

2F 

FOO 

010F 

108.6 

-3 

deg 

c 

30 

F40 

0110 

108.9 

-4 

deg 

c 

31 

F80 

0111 

109.2 

-6 

deg 

c 

32 

FCO 

0111 

109.6 

-7 

deg 

c 

33 

1000 

0112 

109.9 
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-8 deg 

C 

34 

1040 

0113 

110 

.2 




“10 deg 

C 

35 

1080 

0114 

110 

.5 




m i n_b a t_ 

table; 


- 








.word 

$00EC, 

$00EC, 

$00ED, 

$00EE, 

$00E F, 

$00EF, 

-$00F0, 

$00F1 


.word 

S00F2, 

$00F2, 

$00F3, 

$00F4, 

$00F5, 

$00F5, 

.$00F6, 

$00F7 


.word 

$00F8, 

$00F8, 

$00F9, 

$00FA, 

$00F6, 

$00F6, 

‘$00FC, 

$oofd 


.word 

SOOFE, 

$00FE, 

$00FF, 

$0100, 

$0101, 

$0102, 

$0102, 

$0103 


. wo rd 

$0104, 

$0105, 

$0105, 

$0106, 

$0107, 

$0108, 

$0108, 

$0109 


.word 

S010A, 

$0106, 

$0106, 

$010C, 

$010D, 

$010E, 

$010E, 

$010F 


.word 

$0110, 

$0111, 

$0111, 

$0112, 

$0113, 

$0114 




; This routine is caLLed to calculate the running "sum of coulombs" whic 
; the battery state of charge. The basic algorithm calls for the follow 
;calculationtobeperformed: 


; state_of_chg = state_of_chg + (battery_I * iscal /battery_cap) 

/ 

; The basic problem here is dealing with the extremely large range of thi 
; numbers involved. State_of_chg is stored as a 40 bit number with a 
; maximum value of 1. (followed by 39 zeros). For values of iscal and 
; battery capacity of 1/45000 and 400, respectively, and battery_I storet 
; the form, xxx.x, this equation reduces to: 

• 

/ 

; state_of_chg = s t a t e_o f_c ha r ge + (555 * battery_I * (10)'‘-11) 

« 

; If, for the purposes of calculation, we make the binary point right ju: 

; by multiplying thru by (2)*39, the equation becomes: 

• 

/ 

; (5.49 * (10)''11) * state_of__chg = 

; (5.49 * (10)"11) * state of_chg + 

; (5.49 * (10)~11) * (3"55 * battery_I * (10)“-1 

• 

/ 

; Which reduces further, in general, to: 

; (5.49 * (10)"11) * state_of_chg = 

; (5.49*(10)“1D* state_of_chg + 

; (iscal bat cap * battery I) 


; Hence, to calculate a new value of state_of_chg, multiply battery_I by 
; parameterized value, i sea l_bat_cap, which is equal to: 

; 5.49*10'*10*iscal* 1/bat_cap. 

; and add (or subtract) the result to (or from) the running 40 bit value 
; state_of_chg . 

r 

; To read the value of soc, mentally move the binary point left to the or 
; position (i.e. divide by (2)"39) and read the value. 

; If the battery is charging, i.e. the net current is flowing INTO the ba 
; the battery current is multiplied by the coulomb ic efficiency which is 
; function of the state of chg as follows: 


/ 


St ate_of_c hg 

decimal binary 


cou I omb i c_ef f 
decimal binary 
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0 to .6874 
.6875 to .8124 
.8125 to .9062 
.9063 to 1 .000 


< 0 1011000 
< 0 1100000 
< 0 1110100 
< 1 0000000 


1 .00000 
.9063 
.8125 
.6875 


.11101 

.11010 

.10110 


Pseudocode : 


c a L c_s tat e_o f _c h g : 
save pegs ; 
if (battery_I >0) 
then do; 

if ( s t a t e_o f_c hg >= soc_brk1) 

then cou L omb i c_e f f = coul effi; 
else if ( ( s t a t e_of_c hg >= soc_brk2) 

AND ( s t a t e_of_c h a rge < soc brkl)) 
then coulomb i c_e ff = couL eff2; 
else if ( ( s t a t e_of_c hg >= soc brk3) 

AND ( s t a t e_o f_c h a rg e < soc_brk2)) 
then cou Lombi c_ef f = coul_eff3; 
else cou L omb i c_e f f = 1.0; 
battery_I = battery_I * cou L ombi c_e f f ; 
end; 

state_of_chg = state_of_chg + (battery_I * i s c a L_ba t_c a p ) ; see above 
if ( st at e_of_c hg > 1) 

then state_of_chg =1; 
if ( stat e_of_c hg < 0) 

then state_of_chg = 0; 
unsave pegs ; 
end calc_state of chg; 


This poutine is called to calculate a punning total of equalization counts. 
Fop details about dealing with the lapge (40 bits!) equalization count, 
see c a I c_s t a t e_of_c hg . 

Since thepe was och_fpac to deal with, a section of the code fop this 
poutine is a "hapdwired" multiply poutine so that it wouldn't be necessary 
to use the long 16 by 16 multiply poutine. It is assumed, in order to make 
this routine as fast as possible, that the fraction is only 7 bits long, 
and that it is left justified with the binary point at the left end, like 
a fraction should be. In order to minimize the code and the requirement 
for additional zero page storage locations for the interim solutions, some 
of the variable locations used in mp_mult are also used here, as shown belc 


t emp_o c h_f r a c 

/ 

1 i sea l_bat_cap 1 bat_mult2 | / | 


I multi j mult2 j product 


The product of bat_mult2 * och_frac is shifted as it is multiplied, into 
the two bytes occupied by mult2. Temp och frac is overwritten. 


'seudocode : 
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cal c_equa l_count : 
save pegs; 
if (battery_I < 0) ' 
then do; 

temp = (battery_I * och_f rac) /256; 

equal_count = equal_count + (temp * i sea L_bat_cap) ; 

end; 

if ( state_^of_chg >= 1) 

equal_count = equal_count - (battery_I * i sea l_bat_c ap) 
then stat e_o f _c h g = 1 ; 
if (equal_count < 0) . 

then equal_count = D; 
if (equal_count > max_equa l_count) 

then equal_count = max_equa L_count ; 
unsave pegs; 
end caLc_equaL count; 



; This poutine coppects the cuppent state of_chg value fop battepy 
; tempepatupe. 



Pseudocode : 

c o p p e c t_s tat e_o f _c h g : 
save pegs; 

if ( (abs_battepy_V >= .99 * equal_V) OR ( s t a t e_of_c hg > soc_top 
then do; 

state_of_chg = state_of_chg + .01; 
if (state_of_chg > 1.0) then state_of_chg = 1.0; 

end; 

if (abs_battepy_V < min_bat__V) 
then do; 

stat e_o f _c h g = stat e_o f chg - .01; 

if (stat e_o f _c hg < 0) then stat e_o f _c h g = 0 ; 

end; 

index = (bat_temp >> 4) - $D; 
if (index < 0) 

then i ndex = 0; 

c s t a t e_of_c hg = state_of_chg * c so c_t ab I e C i ndex] ; 
un save pegs ; 

end coppect_state_of_chg; 

The following aPe the lookup table fop the values in the exppession: 

value = (1 + coeff * (20.92 * (Vt - 2.56))) 

i- whepe coeff = .0022 fop tempepatupes > 25 deg C 

= .0075 fop tempepatupes < 25 deg C 

In opdep to find the index to a value in the table, take the paw A/D 
value fop Vt, shift pight 4 bits and subtpact $0D. 

NOTICE 1: The value stoped in the table is assumed to have a hexadecime 
point in the centep of the wopd, e.g. $0112 coppesponds to $1.12 
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NOTICE 2: Vt^ as shown below^ is represented in "real volts" format, i.e. 
the number represents the number of 1/1000's of volts. To convert this 
/alue to what is actually stored'in memory, it must be divided by 4. 


CORRECT STATE OF CHARGE TABLE 



temp 


index 

Vt 

hex value 

percent 

61 

deg 

C 

00 

340 

0114 

108% 

60 

deg 

C 

01 

380 

0113 

108% 

58 

deg 

C 

02 

3C0 

0112 

107% 

57 

deg 

C 

03 

400 

0112 

107% 

56 

deg 

C 

04 

440 

0111 

107% 

54 

deg 

C 

05 

480 

0110 

106% 

53 

deg 

C 

06 

4C0 

010F 

106% 

52 

deg 

c 

07 

500 

010F 

106% 

50 

deg 

c 

08 

540 

010E 

106% 

49 

deg 

c 

09 

580 

010D 

105% 

48 

deg 

c 

OA 

5C0 

010C 

105% 

46 

deg 

c 

OB 

600 

010C 

105% 

45 

deg 

c 

oc 

640 

010B 

104% 

44 

deg 

c 

OD 

680 

010A 

104% 

42 

deg 

c 

OE 

6C0 

0109 

104% 

41 

deg 

c 

OF 

700 

0109 

104% 

40 

deg 

c 

10 

740 

0108 

103% 

38 

deg 

c 

11 

780 

0107 

103% 

37 

deg 

c 

12 

7C0 

0106 

103% 

36 

deg 

c 

13 

800 

0106 

102% 

34 

deg 

c 

14 

840 

0105 

102% 

33 

deg 

c 

15 

880 

0104 

102% 

32 

deg 

c 

16 

8C0 

0103 

101% 

30 

deg 

c 

17 

900 

0103 

101% 

29 

deg 

c 

18 

940 

0102 

101% 

28 

deg 

c 

19 

980 

0101 

101% 

26 

deg 

c 

1 A 

9C0 

0100 

100% 

25 

deg 

c 

IB 

AOO 

0100 

100% 

24 

deg 

c 

1 c 

A40 

OOFD 

99% 

22 

deg 

c 

ID 

A80 

OOFA 

98% 

21 

deg 

c 

IE 

ACO 

00F8 

97% 

20 

deg 

c 

1 F 

BOO 

00F5 

96% 

18 

deg 

c 

20 

B40 

00F3 

95% 

17 

deg 

c 

21 

B80 

OOFO 

94% 

16 

deg 

c 

22 

BCO 

OOEE 

93% 

14 

deg 

c 

23 

COO 

OOEB 

92% 

13 

deg 

c 

24 

C40 

00E8 

91 % 

12 

deg 

c 

25 

C80 

00E6 

90% 

10 

deg 

c 

26 

CCO 

00E3 

89% 

9 

deg 

c 

27 

DOO 

00E1 

88% 

8 

deg 

c 

28 

D40 

OODE 

87% 

6 

deg 

c 

29 

D80 

OODC 

86% 

5 

deg 

c 

2A 

DCO 

00D9 

85% 

4 

deg 

c 

2B 

EOO 

00D6 

84% 

2 

deg 

c 

2C 

E40 

00D4 

83% 

1 

deg 

c 

2D 

E80 

00D1 

82% 
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-0 

deg 

C 

2E 

ECO 

OOCF 

81% 

-2 

deg 

C 

2F 

FOO 

OOCC 

80% 

-3 

deg 

C 

30 

F40 

OOCA 

79% 

-4 

deg 

C 

31 

F80 ' 

00C7 

78% 

-6 

deg 

C 

32 

FCO 

00C4 

77% 

-7 

deg 

C 

33 

1000 

00C2 

76% 

-8 

deg 

C 

34 

1040 

OOBF 

75% 

-10 

deg 

C 

35 

1080 

OOBD 

74% 


csoc table: 


.word 

$0114, 

$0113, 

$0112, 

$0112, 

$0111, 

$0110, 

$010F, 

$010F 

.word 

$01 OE, 

$010D, 

$010C, 

$01 OC , 

$01 OB, 

$01 OA, 

$0109, 

$0109 

.word 

$0108, 

$0107, 

$0106, 

$0106, 

$0105, 

$0104, 

$0103, 

$0103 

.word 

$0102, 

$0101 , 

$0100, 

$0100, 

$00FD, 

$00FA, 

$00F8, 

$00F5 

.word 

$00F3, 

$00F0, 

$00EE, 

$00EB, 

$00E8, 

$00E6, 

$00E3, 

$00E1 

.word 

$00DE, 

$00DC, 

$00D9, 

$00D6, 

$00D4, 

$00D1 , 

$00C F, 

$00CC 

.word 

$00CA, 

$00C7, 

$00C4, 

$00C2, 

$00BF, 

$00BD 




This routine, called once per second, performs the actual control of t 
loads connected to the system, as determined by the state variables 
prod_mask (created by det e rm i ne_ma c h_s t a t e) , user_ld_req (set by the u 
from the terminal or keypad), and overld_trip (set by c h k_f o r_o ve r I d) . 
Depending upon the state of charge of the battery (as indicated in 
cstate_of_chg) , various loads are turned on or off so as to maximize 
battery life. In addition, various warning indicators (RED and YELLOW 
LEDs, and the Low Battery indication on the LCD Display) are turned on 
or off to alert the operator to unusual or dangerous conditions. 


Pseudocode : 

she d_restor_ loads: 
save regs ; 

if ((hours >= #$08) AND (hours < #$12) AND 

( tot a l_c hg r_I > (5.12 * 0.1 * *num_load_st r i ngs) ) ) 
then delta = #delta_soc; /* delta_soc = 0.1 */ 
else delta = 0; 
j = stow_leds; 
do i = 4 to 0 step -1; 

if ( ( c s t a t e_of_c hg + delta) < s h ed_t h r e s h C i 0 ) 
then do ; 

j = j AND s hed_ms k_t b I C i D ; 

ignore the next statement and continue loop; 

6nd; 

if ( ( c s t a t e_of_c hg + delta) >= r e s t o r_t h r es h C i D ) 
j = j OR resto r_m s k_t b I C i D ; 

end; 

j = (j OR #ld 6_o n) AND pro d_m ask); 
if ((j S restor_msk_tb IC4D) <> 0) 
then j = j AND #yle d_o f f ; 
else j = j OR #yle d_o n ; 
if ((j AND r e s t o r_ms k_tb I COO ) <> 0) 
then j = j AND #rle d_o f f ; 
else do; 
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j = j OR #rled_on; 
j = j AND #yled_off; 

end; 

sr_temp = j; 

3 = user_ld_req OR #Leds_on; 

sr_teinp = sr_temp AND 3 '; 

if ( ( s r^t emp & #rLe d_o n ) <> 0 ) 

then alarm_fLags = alarm_flags OR #enab Le^Lobat ; 
else alarm_flags = alarm_flags AND #d i sab I e_l obat ; 
if (ovrld_trip <> 0 ) 
then do; 

3 = sr_temp AND "ov r I d__t r i p ; 
stow_leds = j I #rle d_o n ; 

end; 

else stow_leds = sr_temp; 

I ed_ou t_l a t c h = stow_Leds; 
unsave regs; 
end shed restor loads; 


; This routine, called every second, checks the currents in the 5 load 
; strings and if a current exceeds a Limit for more than a certain number 
; of times (this "count" being load specific), the bit corresponding to 
: the Load number that has suffered the overload is set in the ovrld_trip 
: mask, and the load is immediately turned off (as opposed to waiting for 
: the next execution of the shed/restore load routine). 


’seudocode : 

h k_f o r_ov rid: 

save regs; 

do i = 4 to 0 step -1; 
if (bus_ampsCiD < 0) 

then sr_temp = - bus_ampsCi3; 
else sr_temp = bus_ampsCiD; 
if (sr_temp > ov r L d_t h r es h C i 3 ) 
then do; 

ovrld_cntCi3 = ovrld_cntCi3 - 1; 
if (ovr ld_cnt Ci3 = 0) 

then ovrld_trip = ovrld_trip OR o v r I d_t r i p_ms k T i 3 ; 

end ; 

else ovrld_cntCi3 = ov r L d_c n t_ma x C i 3 ; 

end; 

if (ovrld trip <> 0) 
then ?o; 

stow_leds = stow_leds AND “ovrld_trip; 
stow_leds = stow_leds OR #rled_on; 

I ed_ou t_l a t c h = stow_leds; 

alarm_flags = alarm_flags OR #enab I e_be 1 1; 

end; 

unsave regs; 
end chk for ovrld; 


The function of this routine is to determine if more or less array branches 
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should be connected. This routine is entered every time the one sec f 
is set. The pattern for the two PWM Latches are held in bits 0 Thru~6 
stow pwml and stow pwm2. 


Pseudocode: 

d i s c r e t e_a r r a y_c n t r I : 
save reg; 

if ( abs_bat t e ry_V > bat_V_limit) 
then do; 

stow_pwm1 = 0; 
stow_pwm2 = 0; 

end; 

else if (abs_battery_V > (bat_V_Limit * 3D/32) 
then do; 

if (stow_pwm2 = 0) 
then do; 

stow_pwm1 = stow_pwm1 >> 1 ; 
stow_pwm2 = stow_pwm2 >> 1 ; 

end; 

end; 

else if (abs_battery_V < (bat_V_Limit * 30)/32) 
then do ; 

stow_pwm1 = (stow_pwm1 << 1) + 1; 
if (stow_pwm1 AND $40 <> 0) 
then do; 

stow_pwm1 = stow_pwm1 AND $3F; 
stow_pwm2 = (stow_pwm2 << 1) + 1; 
stow_pwm2 = stow_pwm2 AND $3F; 

end; 

end; 

array_sel1 = stow_pwm1 ; 
array_sel2 = stow_pwm2; 
unsave regs; 

end discret e_a rray cntrl; 


; The routine determines which of the four states of the machine (descri 
; below) that the machine should be in based on state of chg and product 
; levels and then sets up those conditions. It is as'sumTd that the prio 
; of functions is: 


state #1 


; state #2 


; state #3 

m 

r 


9 


1. charging the battery 

2. running the load 

3. making product 

battery is so Low that product and Load relays are all 
off (statel = 00000000) 

battery partially charged. Load relays closed, 
product relay open (state2 = 11111000) 

battery close to full charge, load relay open, 
product relay closed (state3 = 00000100) 
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; state #4 battery close to full charge, load relays closed, 

; product relay closed (state4 = 11111100) 

f 

; note 1; When refering to'the fact that the load relays are closed, tl 

; presumes that the overload threshold has not been exceeded. 

/ 

; note 2: The product relay is load #1, the load relays operate as a 

; unit (in so far as this routine is concerned), so that 

; loads 2 thru 5 are turned off and on together. 


; State Diagram: 


( 00 ) 

>STATE 1 — >-- 


(corr soc<soc1) 


(corr so c>so c 1 +bu f so cl ) 


-<■ 


\ / 

\ / 

\ / 

\ (F8) / 

< < — < — STATE 2< >■ 

/ \ 


; (prod<prod1 ) 

: AND 

j(corr soc>soc2+buf soc2) 


I 


(prod1<prod<prod2) 

AND 

(corr soc>soc3+buf soc3) 


(cor r_so c<so c2 ) 

1 


(prod>prod2+bufprod2) 

OR 

(corr soc<soc3) 


I / 

STATE 3<- 
I (04) 

I 

I 


I 


(pr od<prod1 ) 

AND <- 

(corr soc<soc4) 


-< <-• 

.< < <. 




•STATE 4 
I ( FC) 


>(prod>prod1+bufprod1)0R(corr soc>soc4+bufsoc4)-- 


’seudocode : 

J e t e r_m a c h_s t a t e : 
save regs; 

if (prod_mask = statel) 

then if ( c s t a t e_of_c hg > sod ■»- bufsoci) 
then pro d_m ask = state2; 
else if (pro d_m ask = state2) 
then do; 
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I r I 


if Ccstate_of_chg < sod) ***case2*** 

then pro d_m ask = statel; 
else if ((prodi <= prod < prod2) 

AND (cstate_of_chg > soc3 + bufsoc3)) ***case3^ 
then prod_mask = stateA; 
else if ((prod < prodi) 

AND (cstate_of_chg > soc2 +~bufsoc2)) **c« 
then prod_mask = state3; - 

end; 

else if (prod_mask = state3) 
then do; 

if (cstate_of__chg <soc2) ***case5*** 

then prod_mask = state2; 
else if ((prod > prodi + bufprodl) OR 

( c St at e_of_c hg > soc4 + bufsocA) ***case6* 
then prod_mask = stateA 

end; 

else if (prod_mask = stateA) 
then do; 

if ((prod < prodi) AND (cstate_of_chg < socA)) 
then prod mask = state3; ***case7*** 

else if (Tprod > prod2 + bufprod2) 

OR ( c St at e_of_c hg < soc3)) ***case8*** 
then prod_mask = state2; 

end; 

call shed_restor_l oads; 
unsave regs; 
end deter mach state; 


; This routine handles all of the initialization duties, runs the RAM 
; and lamp test . 


Pseudocode : 
test: 


disable interrupts; 

make sure we're in decimal mode; 

stack pointer = $FF; 

p i a_c s r a = d d r_s el; 

pia_csrb = ddr_sel; 

pia_ddra = paddr_mask; 

pia_csra = pa__edge__se I OR ddr__desel; 

pi a_porta = dsply_se l_dsb AND dsply_c lk_of f ; 

pia_ddrb = pbddr_mask; 

pia_csrb = pb__edge_sel OR ddr_desel; 

pia_portb = $0F; 

I e d_o ut_ latch = $00; 
do X = 0 to $FF 

$0000Cx3 = $FF; 

end; 

do X = 0 to $FF 

if ($0000Cx3 <> $FF) 

then call ram error; 
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end; 

do X = 0 to $FF 

S0000Cx3 = $00; 

end; 

dox=0to$FF 

if (SOOOOCxD <> $00) 

then call ram_error; 

end; 

rom_ptr = $0100; 
do while (rom_ptrC1D < max^ram 
$00000 rom_pt rD = $FF; 
rom_ptr = rom_ptr +1; 

end; 

rom_ptr = $0100; 
do while (rom_ptrC1D < max ram 
if ($0000C rom_pt rD <> $FF)' 
then call ram_error; 
rom_ptr = rom_ptr +1; 

end ; 

rom_ptr = $0100; 
do while (rom_ptrC10 < max_ram 
$00000 rom_pt r3 = $00; 
rom_ptr = rom_ptr +1; 

end; 

rom_ptr = #$0100; 
do while (rom_ptr01D < max_ram 
if ( $0000 0 r om__pt r3 <> $00) 
then call ram_error; 
rom_ptr = rom_ptr +1; 

end ; 

pia_portb = bell_on OR $0F; 
call I amp_t e s t ; 
p i a_po rtb = $0F; 
n i t_t i m e r : 

timer csr = t i m e r__r e s e t ; 
timer_csr = I da I l_t i me r s ; 
timer_csr = $0F; 
time r_d ata = $00; 
timer_data = $00; 
timer_data = ma s t e r_mod e I ; 
timer__data = ma ste r^modeh; 
t i me r_c s r = $01 ; 

i me r1 : 


t i me r_dat a 
time r_d ata 
time r_d ata 
time r_d ata 
timer_data 
' timer_data 
i m e r2 : 

time r_d ata 
timer_data 
time r_d ata 
timer_data 
time r__d ata 
timer data 


= cntr1_model; 
= cntr1_modeh; 
= $ 00 ; 

= too; 

= $ 00 ; 

= $ 00 ; 

= cntr2_model; 
= c n t r 2__m o d e h ; 
= $ 00 ; 

= $ 00 ; 

= $ 00 ; 

= $ 00 ; 


size) 


size) 


size) 


size) 
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timer_csr = $43; 
timer_csr = $0A; 
time r_d ata = $59; 
timer_data = $23; 
time r_d ata = $00; 
time r_d ata = $00; 

timer3: 

timer_data = cntr3_modeL; 
timer_data = cntr3_modeh; 
timer_data = cnt r3_Ld_reg; 
timer_data = cnt r3_Ld_reg+1 ; 
timer_data = c n t r3_ho L d_reg ; 
timer_data = cnt r3_ho Ld_reg+1 ; 

t i me r4 : 

timer_data = cntr4_model; 
timer_data = cntr4_modeh; 
timer_data = c nt r4_L d_reg ; 
timer_data = cnt r4_Ld_reg + 1 ; 
timer_data = c n t r4_ho L d_reg ; 
timer_data = cnt r4_ho Ld_reg + 1 ; 

t i m e r5 : 

time r_d ata = cntr 5_m o d e L ; 
timer_data = cntrS modeh; 
timer_data = def_baud_rate; 
timer_data = def_baud_rate+1 ; 
star t_t i m e r s : 

timer_csr = $73; 
timer_csr = $0A; 
timer_data = $00; 
timer_data = $00; 
timer__csr = $E3; 
timer_csr = $E4; 
time r_c s r = $2 C ; 
ini t_z pg : 

c omput e_f I ag s = c omput e_f I ag s OR run_flag; 

sp_stor = $FF; 

c o I umn_numbe r = $08; 

pia_portb = co lumn_numbe r AND $0F; 

write_portb = c o L umn_numbe r AND $0F; 

bounce_count = max_bounce_count ; 

stow_Leds = $00; 

L ed_ou t_L a t c h = $00; 
stow_pwm1 = $00; 
a r r a y_s eL1 = $00; 
stow_pwm2 = $00; 
array_seL2 = $00; 
next_seLdom = $18; 
do X = 4 to 0 step -1 

over Ld_cnt CxD = ove r I d_cnt__ma x FxD ; 
s hed_t h r esh HxD = shed_thCxD; 
restor_th reshCxD = resto r_t h CxD ; 

end; 

St at e_of_c hg C4D = $40; 
inhibit = $01; 
one_sec_timer = 250; 

caLL msg hnd L r (' WELCOME TO THE TRISOLAR DEBUG MONITOR') 
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call displa y_c L r ; 

i_o_fLags = i_o_flags OR dat aset_r eady_f I ag ; 
pia_csra = pa_^edge_seL OR ddr__deseL OR x4_msec_enab; 
enable interrupts; 
goto run_task_master; 

r am__e r ror : 

call displa y_e rror(2); 
call displa y_d i g i t s ; 
loop : 

goto loop; 
end ram error; 


This routine is called every 100 msec to average the 16 readings of each 
of the 12 often read channels. 


’suedocode : 

; i gna l_av : 

do next_often = 0 to num_of_of t en_reads ; 
adc_temp_ho Id = 0; 
do pointer = 0 to max_pass_num; 

adc_temp_ho Id = of t en_r e adC po i n t e r ,n ex t_of t en*3 2D 

+ adc_temp hold; 

end; 

of ten_readCnext__of t enD = ad c__t emp_h o I d/ 1 6; 
end; 

total_chgr^I = 0; 

do index = 2 to num_of_of ten_reads; 

total_chgr_I = dump_a r rayCi ndexD + t ot a l__c hg r_l ; 
end; 

end signal av; 
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An RS-232 port provides data logging or remote control capability. A prototype 
5kW unit has been built and tested successfully. The controller is expected 
to be useful in village photovoltaic power systems, large solar water pumping 
installations, and other battery management applications. 
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